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ABSTRACT 

This  study  discusses  briefly  the  history  of  technical  figure  illustration  in  the 
Computer  Science  Department  of  the  Naval  Postgraduate  School.  The  single 
system  experiencing  the  most  usage  is  the  fully  automated  interactive  graphics 
figure  illustrator—OZDRAW.  During  its  short  and  active  life,  the  need  for 
perfective  maintenance  to  include  generalized  documentation  has  been  recognized. 
The  result  is  a  technical  graphics  figure  illustrator  with  an  improved  user  interface 
titled  NPSDRAW  and  supporting  documentation. 
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I.    INTRODUCTION 

A.    A  NEED  FOR  AUTOMATED  FIGURE  ILLUSTRATORS 

In  academic  environments,  graphical  figures  must  be  made  available  within  a 
period  of  time  equal  to  that  of  the  time  to  complete  the  text.  As  word  processors 
gain  speed  and  can  interact  with  assorted  programs  that  check  spelling, 
compute  arithmetic  values  within  text  and  even  evaluate  writing  style,  there  is 
the  need  for  a  quick  effective  means  of  providing  associated  illustrations.  The 
pressure  upon  the  illustrator  for  completion  of  his  product  is  increased  each  time 
new  software  and/or  hardware  provides  faster  output  of  a  final  text  product. 
The  only  means  by  which  the  illustrator  can  keep  pace  with  the  word  processor 
improvements  is  to  utilize  a  system  that  is  quick,  easy  to  learn,  powerful  and 
uncomplicated  to  operate  even  for   the  most  infrequent  user. 

In  the  Computer  Science  (CS)  Department  of  the  Naval  Postgraduate  School, 
the  need  for  semi- automated  or  fully  automated  illustration  systems  has  been 
served  by  a  variety  of  systems  such  as  the  PIC  Graphics  Language,  FIGURE 
Graphics  Illustrator  Program  and  most  recently.  OZDRAW,  an  interactive 
graphics  figure  illustrator.  PIC  is  a  procedural  language,  in  which  the  user 
specifies  the  motions  that  one  goes  through  drawing  a  figure.  The  language  is  the 
implementation  of  a  "semi-automated"  system,  i.e.  having  no  real-time  computer 
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graphics  representation  during  the  drawing  process.  The  user  must  maintain  a 
mental  or  physical  image  of  his  proposed  drawing,  and  utilize  multiple  drawing 
commands,  variable  names  and  values,  positioning  data  and  attributes  to  provide 
the  input  "coded  text"  before  generation  of  his  final  product. 

FIGURE  is  a  departmentally  produced  semi-automated  system  that  produces 
an  illustration  by  using  the  users  input  of  coded  text  similar  to  that  of  PIC. 
FIGURE  requires  only  the  primitive  figure  name  and  position  to  be  drawn. 
Various  line  styles,  line  widths,  fonts  and  fill  patterns  are  simply  identified  as 
change  is  required.  The  text  then  is  processed  to  generate  the  final  product. 

OZDRAW  is  the  first  fully  automated  system  available  for  general  usage 
within  the  CS  department.  The  user  has  real-time  feedback  in  the  form  of  a 
drawing  on  a  monitor  of  a  graphics  workstation.  This  system  actually  permits  the 
user  to  do  the  actual  drawing.  The  drawing  is  then  converted  to  data  acceptable 
by  FIGURE.  OZDRAW  does  not  require  the  user  to  learn,  nor  even  be  concerned 
with  the  assignment  of  primitives,  positioning  data  or  attribute  assignment  format 
in  the  "coded  text"  file  used  by  FIGURE.  The  user  simply  draws  his  illustration 
on  the  monitor,  saves  it  to  a  file,  and  then  prints  out  that  illustration  by  invoking 
FIGURE. 
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B.    SYSTEM  DRAWBACKS 

1.  PIC  Graphics  Language 

As  with  all  semi-automated  systems,  the  major  deficiency  of  PIC  is  the 
lack  of  real-time  feedback  as  the  product  is  "laid  out"  or  drawn  before  actual 
printing.  This  requires  the  user  to  have  a  detailed  sketch  or  hand  drawn 
illustration  to  work  from  and  determine  specific  numeric  values.  The  program 
then  must  be  written  to  reflect  the  sketch  and  finally  processed  for  printing. 
Though  simple  drawings  are  accomplished  somewhat  easily,  modifications  of  any 
nature  tend  to  increase  the  complexity  of  the  code.  Modification  of  figure  size, 
attributes,  positioning  data,  as  well  as,  general  picture  size  require  a  complete 
understanding  of  the  system.  PIC  is  powerful,  but  complex  and  sometimes 
difficult  even  for  experienced  users.  Furthermore,  PIC  lacks  any  capability  for  fill 
patterns. 

2.  FIGURE  Illustration  Program 

FIGURE  experiences  the  same  major   deficiency  of  all  semi-automated 

systems,  i.e.  the  lack  of  real-time  feedback.   It  was  designed  though  for  use  by 

inexperienced  and  infrequent  users.    With  each  primitive  figure's  position  specified 

in  the  text,  simple  modifications  to  positioning,  attributes,  etc.  are  accomplished 

through    the    simple    editing    of   text.    As    an    illustration    increases    in   size   and 

complexity,  textual  change  becomes  tedious  and  difficult.  Modification  to  a  single 

figure   for    repositioning,    or    attribute   change   can    be    accomplished   with   little 

difficulty,  but  movement  of  a  block  of  figures    requires  extensive  editing  of  the 
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text.  As  with  all  semi-automated  systems,  FIGURE  and  PIC  require  the  user  to 
be  knowledgeable  of  the  local  text  editor  on  the  computer  system  being  used. 
Additionally,  the  user  needs   acceptable  typing  skills  to  reduce  the  amount  of 
compiler  and  system  errors  incurred  during  processing  of  coded  text. 
3.     OZDRAW  Interactive  Graphics  Figure  Illustrator 

OZDRAW  is  a  real-time,  interactive  figure  generation  system.  It  has  been 
designed  primarily  to  run  on  the  IRIS  2400  series  of  computer  graphics 
workstations  manufactured  by  Silicon  Graphics,  Inc  of  Mountain  View, 
California.  The  output  of  the  system  is  designed  for  any  graphics  capable  laser 
printer.  The  primary  laser  printer  for  the  OS  department  is  a  Quality  Micro 
System  (QMS)  Lasergraphic  1200  . 

The  aim  of  OZDRAW  is  to  provide  a  powerful,  user-friendly  figure 
generation  system  to  enhance  the  technical  figures  required  by  the  Computer 
Science  Department  at  the  Naval  Postgraduate  School  [Ref.  l].  Since  its 
production,  OZDRAW  has  been  utilized  by  a  large  number  of  thesis  students  and 
faculty.  It  has  become  the  most  popular  figure  illustration  system  in  the 
department.  With  the  system's  popularity,  it  has  become  apparent  that  some  of 
the  initial  design  features  are  a  hinderance  to  the  experienced  user.  Various  users 
have  expressed  a  desire  to  see  features  expanded,  as  well  as  new  capabilities  added 
to  the  original  version.  The  following  are  often  cited  areas  of  OZDRAW^  design 
deficiencies: 
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o  Inefficient  attribute  specification  and  display  features. 

o  Menu  organization  requires  traversal  through  numerous  levels  to  accomplish 
related  system  functions. 

o  Limited  font  specifications  /  descriptions. 

o  Lack  of  texture  representation  during  real-time  feedback  of  drawing. 

o  Insufficient  line  width  selections. 

o  Tedious  attribute  change  mechanics. 

o  Unavailability  of  common  geometric  figures. 

o  Inability  to  scale  individual  figures  and  blocks  of  figures. 

o  Lack  of  figure  alignment. 

o  Foreign  figure  data  utilization  /  conversion. 

To  date,  there  have  been  two  implementations  of  OZDRAW  put  into 
daily  use  with  the  diff'erences  between  the  systems  being  only  in  the  method  of 
selecting  menu  options.  This  study  revolves  around  the  actual  maintenance  of 
OZDRAW  originally  written  by  Steve  Firth  in  1985/86  [Ref.  l]  and  examines  the 
addition  of  new  features  to  OZDRAW,  retitled  NPSDRAW.  These  changes  are 
compatible  with  the  OZDRAW  and  FIGURE  file  formats.  Primary  focus  of 
attention  is  on  the  overall  design  and  implementation  of  that  new  system. 
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II.    NPSDRAW:  SYSTEM  OVERVIEW 

A.    SYSTEM  CAPABILITIES 

The  program  used  as  a  basis  for  NPSDRAW  was  originally  written  by  Steve 
Firth  in  a  1985  master's  thesis  titled  "OZDRAW  -  An  Interactive  Graphic  Figure 
Illustrator".  Our  goal  was  to  provide  an  improved  user  interface  for  that  system. 
Additionally,  new  features  as  well  as  system  enhancements  were  included. 

1.     Primitives  Supported  by  NPSDRAW 

Most  figures  that  are  needed  in  technical  figure  illustration  can  be  derived 
from  the  primitives  supported  by  NPSDRAW.  The  available  primitives  are  listed 
in  Table  2.1. 


TABLE  2.1   NPSDRAW  PRIMITIVE  FIGURES 

Primitives 

Variations 

Polygons 

Rectangles,      Squares,      Diamonds, 
Triangles  and  Arrowheads 

User  Formed  Polygons 

Circles  &  Ellipses 

Arcs 

Straight  Lines 

Vertical,     Horizontal,     Single     and 
Multiple  Lines 

Smooth  Cursive  Lines 

Seed  Points 

Used     to     provide     a     fill     pattern 
(texture)  for  concave  figures 

Text 

Single  lines  of  Text 
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2.      NPSDRAW  Figure  Attributes 

Each  figure  generated  with  NPSDRAW  is  assigned  specific  attributes 
that  define  its  appearance.  The  attributes  are  for  line  width,  line  style,  texture  (fill 
pattern)  and  font.  Specific  attribute  values  available  are  dependent  on  the  current 
graphics  printer  installed.  Table  2.2  shows  the  default  settings  and  some  of 
available  settings  for  the  QMS  1200  LaserGraphic  Printer  currently  installed.  A 
complete  listing  available  attributes  with  examples  can  be  found  in  Appendix  A. 

The  IRIS  workstations  provide  only  one  predefined  font.  All  text  is 
displayed  using  that  one  font.  To  show  size  differentials  of  the  actual  font  as 
displayed  on  the  laser  printer,  NPSDRAW  generates  a  red  rectangle  around  the 
text.  This  rectangle  represents  the  actual  printed  size  of  the  character  string. 
Note:  this  rectangle  can  be    either  larger  or  smaller  than  the  text  characters 


TABLE  2.2   FIGURE  ATTRIBUTES 

FOR  NPSDRAW 

Attribute 

Default  Value 

Selections 

Line  Style 

Solid 

Solid,         Large       Dash, 
Mediunn  Dash,  Dotted 

Line  Width 

1  pixel  (screen),  0.01"  (printed) 

0.01"  to  0.10"  (printed) 

Texture 

Clear 

25      possible      including. 
Clear,      Solid,      Shaded, 
Horizontal,     Vertical    &; 

• 

Oblique  Lines,  and  vari- 
ous patterns 

Fonts 

Roman  6-LPI,  10-CPI 

Over    100    possible:    Ro- 
man,   San    Serif,    Type- 
writer,    Slanted,     Bold, 
Special     Symbols,     with 
sizes   ranging   from   6-10 
to  8-15 
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displayed.  Textures  are  accurately  shown  with  each  figure  when  drawn.    A  pallet 
of  the  available  textures  is  on  screen  at  all  times. 

3.  The  Screen  Display 

The  primary  screen  layout  of  NPSDRAW  is  shown  in  Figure  2.1. 
NPSDRAW  does  not  display  the  entire  page  but  only  a  clipped  version  (8.5"  x 
8.5")  of  the  page  at  any  one  time.  The  image  on  the  screen  is  approximately  25% 
larger  than  the  printed  image.  In  horizontal  page  alignment,  the  entire  height  is 
seen,  but  not  the  full  width.  When  in  vertical  alignment,  the  full  width  is  seen 
but  not  the  height.  The  user  can  move  about  the  page  when  in  editing  or  drawing 
functions  via  the  Arrow  (cursor)  keys  of  the  keyboard. 

Initially,  NPSDRAW  provides  a  quarter-inch  grid  overlaying  the 
drawing  area.  Discussion  of  this  grid  is  covered  in  section  B.l.  Superimposed  on 
the  drawing  area  is  a  permanent  red  dashed  rectangle.  This  rectangle  represents 
the  thesis  margins  used  at  the  Naval  Postgraduate  School.  There  are  no  limits 
though  on  where  the  user  can  draw,  even  to  the  boundaries  of  the  page. 

The  right  side  of  the  screen  provides  instructions  for  the  currently 
selected  functions.  The  current  settings  of  the  attributes  are  also  displayed  (Figure 
2.2).  Lastly  a  pallet  with  all  possible  textures  (fill  patterns)  is  maintained  for  user 
reference  and  selection  of  textures  in  changing  attributes  (Figure  2.3). 

4.  The  Printed  Page 

NPSDRAW    is   designed   to   produce   figures  for   a  standard   paper  size 

(8.5"  X  11");  the  size  cannot  be  changed.  NPSDRAW  does  allow  the  picture  to  be 
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Set  TEXTURE   Line  Settincis 


0.01  in. 


Current  Font 


Roman 

No.=  0  6  LPI   10  CPI 


Figure  2.2  Current  Attribute  Settings  Display- 


Figure  2.3  Texture  (fill  pattern)  Pallet 
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either  vertically  oriented  (portrait)  or  horizontally  oriented  (landscape),  i.e.  either 
8.5"  X  11"  or  11"  X  8.5"  respectively. 
5.      The  IRIS  Mouse  and  Cursor 

NPSDRAW  uses  mainly  the  mouse,  and  to  a  lesser  extent  the  keyboard, 
for  user  input.  Menu  choices  and  texture  selection  are  done  via  the  mouse.  All 
text  is  entered  via  the  keyboard.  Full  screen  movement  is  accomplished  via  the 
cursor  control  keys  (arrow  keys). 

The  IRIS  mouse  has  three  buttons  associated  with  it,  located  at  the  top 
end  of  the  mouse.  These  buttons  are  referred  in  this  manual  as  the  Left  (LM), 
Middle  (MM)  and  Right  (RM)  mouse  buttons.  The  locations  are  self- 
explanatory.  Moving  the  mouse  across  an  appropriate  surface  moves  the  position 
of  the  cursor  on  the  workstation  screen.  The  cursor  can  appear  as  a  small  red 
arrow  (menu  selections),  red  crosshairs  (texture  selection)  or  black  pencil  (drawing 
mode).  Pressing  a  button  will  perform  a  unique  operation  for  the  current 
function*.    The  function  of  each  button  is  explained  on  the  screen  at  all  times. 

B.     MENU  ORGANIZATION 

The  program  is  menu  driven  with  selections  made  through  the  use  of  the 
mouse.  The  options  in  a  menu  are  highlighted  through  movement  of  the  mouse  up 
and  down.  When  the  appropriate  selection  is  highlighted  (arrow  and  background 


*  Sometimes  when  pressed,  the  mouse  button  gives  a  "double  bounce",  i.e.  it  appears  to  the 
system  and  its  user  that  the  key  has  been  pressed  more  than  once.  This  occurrence  can  be  annoying 
as  it  produces  results  that  are  not  expected.  It  is  therefore  recommended  that  the  mouse  buttons 
be  pressed  in  a  crisp,  sharp  manner  to  avoid  this  situation. 
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color  change),  it  is  selected  by  pressing  the  middle  mouse  button  (MM). 
Throughout  the  program,  the  function  of  each  mouse  button  is  identified  on  the 
right  side  of  the  drawing  area  in  an  area  titled  KB  &  MOUSE  BUTTON 
FUNCTIONS.  The  organization  of  the  program  is  discussed  in  the  following 
explanations  of  each  available  menu. 
1.      Main  Menu 

The  first  menu  displayed  after  start  up  and  selection  of  the  screen 
orientation  is  the  MAIN  MENU  (Figure  2.4).  There  are  16  active  options  in 
the  menu.  The  menu  should  be  thought  of  as  being  divided  into  four  functional 
areas:  Figure  Generation,  Page  Editing,  File  Storage  Sz  Recall  and  Attribute 
Selection. 

The  first  area  of  Figure  Generation  is  comprised  of  the  first  two  options. 
"Draw  Figures"  presents  the  user  with  the  FIGURE  MENU  (Figure  2.5)  for 
selection  of  one  of  the  available  primitives.  Lines  are  reached  through  the  second 
option  "Draw  Lines"  which  presents  the  LINE  MENU  (Figure  2.6).  Each  menu 
lists  the  various  figures  and  line  modes  possible.  The  associated  attributes  of 
those  figures  can  be  changed  from  the  same  level. 

The  second  functional  area  is  comprised  of  options  three  thru  eight  of 

the   main   menu.     These  options  concern  editing   the   page  and   specific   figures. 

SINGLE  EDIT  (Figure  2.7)  and  BLOCK  EDIT  (Figure  2.8)  provide  the  user 

with  means  to  arrange  single  or  multiple  figures  on  the  page.    "Figure  Attributes" 

selects  the  FIGURE  ATTRIBUTES  MENU  (Figure  2.9)  display  and  allows 
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the  changing  of  attributes  of  a  selected  figure.  TOGGLE  GRID  varies  the 
grid  overlay  between  a  1/4",  1/2"  and  no  overlay  on  the  drawing  area.  This  grid 
is  not  printed  on  the  final  product.  The  grid  is  displayed  in  green  with  the  1/2" 
divisions  thicker  than  the  1/4"  divisions.  ERASE  PAGE  (Figure  2.10)  clears 
the  drawing  area  and  VIEW  PAGE  permits  the  user  to  view  his  drawing  in  an 
undipped  format  with  reduced  scale. 

The  FILE  RECALL  MENU  (Figure  2.11)  is  accessed  through  the 
"Read  File"  option.  The  "Write  File"  option  brings  up  the  FILE  STORAGE 
MENU  (Figure  2.12). 

The  last  area  of  the  main  menu  includes  the  Attribute  Change  options. 
Each  option  prompts  the  user  with  the  steps  required  to  change  the  desired 
attribute  setting.  It  is  through  these  options  that  attributes  are  set  for  figures  yet 
to  be  drawn.  The  previously  discussed  option  of  "Figure  Attributes"  allows 
changing  attributes  of  figures  already  drawn.  Finally  the  last  option  "Exit 
System",  is  the  option  used  to  terminate  the  program. 
2.      Figure  Sz  Line  Menus 

The    Figure    Menu    is    obtained    through    the    selection    of   the    "Draw 

Figures"    option   of  the   Main   Menu.    This   menu    permits   the   selection   of  the 

drawing  routine  of  rectangles  (squares),  circles,  user  specified  polygons,  ellipses, 

diamonds,  triangles,  a  fixed  size  arrowhead,  and  a  seed  for  designating  a  texture 

for  a  concave  area.  The  Line  Menu  provides  the  options  of  vertical,  horizontal, 

single   (any  direction),  and  multiple  attached  straight  lines.     A  smooth  cursive 
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style  line  and  arcs  are  also  available.  The  attributes  associated  with  the  figures 
can  also  be  set  from  these  menus.  The  "Exit"  option  returns  the  user  to  the  Main 
Menu. 

All  drawing  functions  differ  slightly  in  operation  but  are  basically 
similar.  To  begin  drawing,  press  the  middle  mouse  button  (MM).  To  finish 
drawing,  press  MM  again.  The  functions  of  the  mouse  buttons  are  always 
displayed.  All  functions  are  easy  to  use  and  most  users  are  comfortable  with  the 
drawing  process  after  several  minutes  of  experimentation.  However,  for 
completeness,  a  quick  procedural  sequence  for  each  figure  is  given  in  Table  2.3. 
3.      Single  «S^  Block  Edit  Menus 

The    Single    and    Block    Edit    Menus    are    the    two    interactive   editing 

facilities  of  NPSDRAW.  Single  Edit  offers  movement,  deletion,  reproduction,  or 

recovery  of  a  deleted  figure.   Selection  of  individual  figures  is  accomplished  by 

positioning  the  cursor  over  the  control  point  of  a  figure  and  pressing  the  middle 

mouse  button.     Control  points  are  corners  of  a  polygon,  centers  of  circles  and 

ellipses,  ends  of  lines  and  arcs,  and  the  beginning  of  text  strings.    If  an  object  is 

found,  NPSDRAW  will  cause  the  figure  to  blink.    The  user  confirms  the  blinking 

figure  to  be  correct  by  pressing  the  middle  mouse  button,  or  else  rejects  it  by 

pressing  either  outside  mouse  button.  After  a  figure  is  rejected,  another  figure  may 

blink  if  in  the  bounds  of  the  system's  pick  mechanism.  Once  a  figure  is  confirmed, 

the  desired  editing  function  can  be  performed.  If  no  figure  is  found,  than  an  error 

message  is  displayed. 
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TABLE  2.3  BRIEF  PROCEDURAL  DRAWING  SEQUENCES 

Rectangles 

Press  the  middle  mouse  button  to  drop  the  first  comer 
of  the  rectangle,  move  the  cursor  to  draw  the  rectangle 
and  press  the  middle  mouse  button  when  finished. 

Circles 

Press  the  middle  mouse  button  to  choose  the  center  of 
the  circle,   move  the  cursor  until   the  circle  is  drawn, 
pressing  the  middle  mouse  button  to  stop  drawing. 

Polygon 

Press  the  middle  mouse  button  to  drop  the  first  point 
of  the  polygon,  move  the  cursor  and  press  the  middle 
mouse  button  again  to  drop  subsequent  points.  When 
the  figure  is  complete  press  the  left  mouse  button. 

Ellipses, 

Diamonds, 

Triangles 

Press  the  middle  mouse  button  to  drop  the  first  comer 
of    a    rectangle,    and    move    the    cursor    to    draw    the 
rectangle   that  will   circumscribe   the  figure.   Press  the 
middle   button   when   finished   and   the  figure  will   be 
drawn. 

Arrow  heads 

Designate  the  position  of  the  arrowhead  tip  by  pressing 
the  middle  mouse  button  and  select  the  direction  by 
positioning   the  cursor  on   the  arrowhead  axis  behind 
the  tip.  A  dotted  line  will  appear  indicating  the  axis. 
When  in  position,  press  the  middle  mouse  button  and 
the  arrow  head  will  be  drawn. 

Drop  a  seed 

Select   the  position  of  the  seed  point   by   pressing  the 
middle  mouse  button.  The  area  that  encloses  the  seed 
point    will    have   the   texture   currently    set.    The   seed 
point  will  not  be  printed. 

Single  Lines 

Select  the  first  point  using  the  middle  mouse  button. 
Move   the  cursor  to  complete  the  Une  and  press  the 
middle     mouse     button     to     stop.     The     vertical     or 
horizontal    line   option    restricts    line   drawing    to   the 
appropriate  direction. 

Connected  Lines 

Select  the  first  point  using  the  middle  mouse  button. 
Move  the  cursor  to    subsequent  points  and  drop  by 
pressing   the  middle   mouse   button.    When  complete, 
press  the  left  mouse  button. 

Smooth  Line 

Press  the  middle  mouse  button   to  set  the  beginning 
point.  Move  the  cursor  as  required  to  complete  the  line. 
When  complete,  press  the  middle  mouse  button. 

Arc 

Press  the  middle  mouse  button  to  choose  the  center  of 
the  arc.  Move  the  cursor  to  draw  the  circle,  pressing  the 
middle    mouse    button    when    the    correct    radius    is 
selected.  Next  press  the  middle  mouse  button  to  select 
the  start  of  the  arc.  Move  the  cursor  counter-clockwise 
and  press  the  middle  mouse  button  to  select  the  angle 
of  the  arc. 
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Block  Edit  offers  movement,  deletion,  reproduction  of  two  or  more 
figures  (blocks),  movement  of  the  complete  picture  about  the  page,  and  a  block 
append  mode.  Selection  of  blocks  is  carried  out  by  the  user  drawing  a  special 
rectangle  around  the  desired  figures.  If  any  figure  has  a  control  point  within  the 
rectangle,  it  is  included  in  the  selected  edit  function. 

Movement,  deletion  and  reproduction  is  similar  to  the  single  edit 
function.  Moving  the  entire  page  is  straightforward.  The  page  is  reduced  into  an 
undipped  image  so  that  the  user  can  see  the  page  as  a  whole.  Use  of  the  arrow 
keys  moves  the  picture  about  the  page.  This  option  is  useful  when  a  picture  is 
complete  and  requires  centering  on  the  page.  The  Block  Append  mode  permits 
reading  in  a  file  but  rather  than  immediately  fixing  the  image  to  the  drawing 
area,  it  is  attached  to  the  cursor  for  positioning  and  placement.  This  facility  is 
useful  for  special  figures  not  in  the  primitive  set. 
4.      Figure  Attributes 

The   Figure   Attributes    menu  is  acquired  by  selection  of  the   "Figure 

Attributes"  option  presented  in  either  the  Main    or  Figure  Menus.  The  user  is 

prompted  to  select  a  single  figure  via  control  points.  Once  a  figure  is  accepted,  the 

attributes  menu  appears.    Selection  of  any  attribute  from  the  menu  activates  the 

sequence  to  change  it.    Only  a  single  attribute  can  be  changed  on  a  selected  figure 

at    a    time.    If   additional    attributes   need    to   be   changed,    the    figure   must    be 

reselected.    The    presentation    of    this    menu    is    the    method    for    reviewing    the 

attributes  of  a  figure. 
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5.  Clear  Screen  Menu 

There  are  two  methods  for  clearing  the  drawing  area  of  all  images.  First, 
the  user  can  remove  the  figures  through  use  of  the  single  or  block  edit  remove 
functions.  Individual  figures  can  be  recovered  at  a  later  time  in  the  same  drawing 
session.  If  complete  clearing  of  the  screen  is  necessary,  then  selection  of  the  "Erase 
Page"  option  of  the  Main  Menu  displays  the  Clear  Screen  Menu.  The  choices  on 
that  menu  are  to  "Clear  the  Screen"  or  "Continue"  drawing.  If  the  picture  is  not 
stored  before  erasure,  it  is  lost  forever.  If  the  decision  to  not  clear  is  made,  the 
user  needs  only  to  select  "Continue". 

6.  Read  Sz  Write  File  Menus 

To  print  a  file  or  save  a  drawing,  the  figures  need  be  stored  in  a  file. 
Naturally,  there  is  a  facility  to  retrieve  this  drawing  from  a  file.  A  directory 
listing  is  available,  listing  only  those  files  contained  in  the  user's  current  directory. 
The  Read  and  Write  operations  are  selected  from  the  Main  Menu  and  are  similar 
in  format.  The  user  provides  a  file  name  entered  from  the  keyboard. 

If  the  user  wishes  to  read  a  file,  NPSDRAW  checks  two  conditions.  First 

it  checks  if  the  file  exists.  If  the  file  does  not  exist,  the  user  is  informed.  Second, 

the    system   checks    if   any    figures   are   displayed   on   the   screen.     If  there   are, 

NPSDRAW    asks   the   user  if  he  wishes  to   "Discard"   the  displayed   figures,  or 

"Merge"  the  two  files.    When  writing  to  a  file,  NPSDRAW  checks  if  the  file  exists. 

If  it  does  not,  it  creates  the  file  and  store  the  figures  in  it.  However,  if  the  file  does 

exist,  the  user  is  asked  if  he  wishes  to  "Append"  the  figures  to  the  end  of  the  file, 
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"Overwrite"  the  contents  or  "Quit".  Overwriting  the  contents  of  a  file  destroys  its 
contents. 

7.  Line  Style  Menu 

The  Line  Style  Menu  (Figure  2.13)  is  presented  through  selection  of  the 
"Change  LineStyle"  option  from  a  menu  or  via  selection  of  changing  the  line  style 
from  the  Figure  Attributes  Menu.  The  menu  lists  four  line  styles.  Styles 
currently  available  are  solid  (continuous)  line,  large  dashed,  medium  dashed  and 
dotted  lines.  Upon  selection  of  a  style,  the  user  is  returned  to  the  controlling 
menu.  Whenever  the  user  enters  the  Line  Style  Menu,  he  can  exit  without 
making  any  changes. 

8.  Line  Width  Menu 

The  Line  Width  Menu  (Figure  2.14)  is  presented  through  selection  of  the 
"Change  LineWidth"  option  from  a  menu  or  via  selection  of  changing  the  line 
width  from  the  Figure  Attributes  Menu.  The  menu  lists  options  of  line  widths 
from  0.01"  to  0.10",  variable  selection  and  no  change.  Variable  selection  provides 
line  widths  from  0.01  to  1.00"  in  increments  of  0.01".  Upon  selection  of  a  width, 
the  user  is  returned  to  the  controlling  menu  from  which  the  call  was  made.  The 
variable  option  operates  and  provide  line  widths  up  to  1.00"  for  NPSDRAW. 
Screen  representation  and  storage  in  memory  reflect  the  selected  size,  but  when 
printed  with  the  QMS  1200  Printer,  the  line  width  will  not  exceed  0.10". 
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9.      Font  Source,  Font  Style  and  Font  Sizes  Menus 

The  Font  Source  Menu  (Figure  2.15)  is  presented  through  selection  of 
the  "Change  Font"  option  from  a  menu  or  via  selection  of  changing  the  font  from 
the  Figure  Attributes  Menu.  This  menu  permits  selection  of  the  font  by  number, 
or  style  and  size.  The  user  can  choose  the  number  entry  method  of  font  style  as  a 
result  of  his  experience  with  OZDRAW  /  NPSDRAW,  or  he  can  select  the  font 
by  style  method  and  make  selection  by  the  style  and  size  that  suits  his  needs 
(Figure  2.16)*. 


Not  all  font  sizes  and  styles  are  available.  See  Appendix  A  for  font  availability. 
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III.    NPSDRAW  -    SOFTWARE  IMPLEMENTATION  DETAILS 

The  origin  of  NPSDRAW  is  as  part  of  an  M.S.  thesis  by  Steve  Firth  [Ref.  l]. 
Modification  of  that  system  began  with  improvements  to  the  user  interface. 
OZDRAW  is  a  medium  size  program,  10  -  20  K  Hne  of  source  code  [Ref  2].  The 
difficulty  with  the  system  lies  in  the  fact  that  the  number  of  functions  and  their 
inter-relationship  was  not  well  documented.  To  discuss  the  implementation  and 
areas  of  modification,  one  must  first  be  aware  of  the  basic  graphics  technique  of 
double  buffering  and  be  knowledgeable  of  the  data  structures  used  in  data 
manipulation.  Discussion  of  the  more  than  160  functions  is  then  clearer. 

A.     BASIC  GRAPHICS  OPERATING  SYSTEM 

Before  any  discussion  on  the  system  design  as  a  whole  can  be  accomplished, 
one  must  have  a  basic  understanding  of  the  method  by  which  the  drawn  figures 
are  presented  to  the  user.  The  smooth  "animated"  appearance  of  the  drawing  area 
is  accomplished  through  the  use  of  a  display  technique  called  Double  Buffering. 
This  technique  refers  to  the  feature  of  dividing  all  available  bitplanes  into  two 
groups,  where  only  one  set  is  viewed  at  a  time.  Each  group  is  called  a  buffer  with 
the  visible  buffer  referred  to  as  the  Front  Buffer  and  the  non-visible  as  the 
Back  Buffer.  With  this  organization  all  writing  and  drawing  is  done  to  the  back 
buffer,  thus  alleviating  any  apparent  drawing  on  the  front  buffer.  All  drawings 
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appear  "instantaneously"  to  the  user's  eye.  unless  the  operating  system  as  a  whole 
is  slowed  down  by  either  too  large  a  drawing  or  other  background  processes.  The 
back  buffer  is  continuously  drawn  to  and  immediately  "swapped"  with  the  front 
buffer  so  that  all  screen  activity  viewed  by  the  user  is  seen  as  "smooth  &  fluid". 

B.     DATA  STRUCTURES 

Within  NPSDRAW,  there  are  two  primary  data  structures.  The  first,  object, 
is  a  computer  graphics  system  structure  to  store  the  graphics  primitives  that 
generate  a  figure.  The  second  is  a  linked  list  of  structures,  named 
dra-wing  struct,  that  contains  the  object,  various  parameters  for  drawing  the 
object,  numeric  information  and  pointers  to  adjacent  members  of  the  linked  list. 

1.  Object 

The  object  is  the  graphics  system's  method  of  storing  a  particular  figure 
for  later  recall  without  the  re-execution  of  the  drawing  routines.  The  drawing 
primitives  are  stored  within  the  object.  With  a  system  call  using  the  object's 
name,  the  figure  definitions  are  retrieved  and  written  to  the  back  buffer.  In  our 
system,  the  object  does  not  contain  data  such  as  line  width,  line  style,  texture  or 
font  selection.  Each  object  can  be  redefined  to  reflect  figure  modifications.  The  use 
of  objects  permits  easy  copying  for  insertion  into  other  structures. 

2.  Drawing  Struct 

The  variable  drawing  struct  is  a  structure  in  the  C  language  analogous 
to  the  record  construct  in  PASCAL.  This  is  the  element  of  the  linked  list  which 
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contains  all  data  unique  to  each  figure.  As  seen  in  Table  3.1,  draAving  struct 
contains  the  figure  definition  (object),  the  figure  attributes,  numeric  information 
and  additional  pointers  to  adjacent  elements  of  the  linked  list.  All  this  data  is 
necessary  to  permit  the  easy  manipulation  of  single  or  group  figures,  storage  in 
files  and  subsequent  printing  of  full  page  pictures.  It  is  the  sequential  reading  of 
these  structures  in  the  linked  list  that  permit  the  continuous  drawing  of  the 
figures  to  the  back  buff"er.  The  elements  of  the  linked  list  can  be  "turned  off'  from 
view  as  required  to  represent  removal,  or  can  be  designated  a  figure  on  which  a 
particular  operation  is  performed. 

C.     SOFTWARE  IMPLEMENTATION 

C  is  the  language  of  implementation  for  NPSDRAW.  All  segments  of  the 
program  are  referred  to  as  functions.  With  the  large  number  of  functions  in 
NPSDRAW,  the  best  approach  to  a  description  of  each  function  is  follow  through 
the  program  and  discuss  the  areas  using  the  organization  of  the  Main  Menu  as  a 
guide. 

1.      Initialization  and  General  Functions 

Most  functions  called  in  the  "main"  function  deal  with  the  initialization 
of  NPSDRAW  for  the  current  drawing  session.  The  call  of  main  menu()  provides 
the  user  access  to  drawing  routines,  file  storage  and  recall,  and  attribute  change. 
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TABLE  3.1    COMPONENTS  OF  STRUCTURE 

"DRAWING    STRUCT" 

Component 

Type 

Explanation 

type 

short 

Records  the  TYPE  of  figure,  i.e.  CIRCLE, 
RECTANGLE,  TEXTS  etc. 

exists 

short 

Is  the  figure  in  existence?,  i.e.  visible  on  the 
screen  or  deleted  but  recoverable. 

this   font 

short 

Font   with   which    this   figure   was   drawn. 
Used  only  with  TEXTS  but  recorded  for  all 
figures. 

this    texture 

short 

Texture  with  which  this  figure  was  drawn. 
Recorded  for  all   figures  though  all  do  not 
use  it. 

this    linestyle 

short 

Line  Style  with  which  the  figure  was  drawn. 
Recorded  for  all   figures  though  all  do  not 
use  it. 

this   linewidth 

short 

Line    Width    with    which    the    figure    was 
drawn.   Recorded  for  all  figures  though  all 
do  not  use  it. 

real    linewidth 

float 

Line    Width    with    which    the    figure    was 
drawn.   Recorded  for  all   figures  though  all 
do  not  use  it.  Line  width  read  in  can  be  of 
any  value.  NPSDRAW  maps  the  value  read 
in  to  one  of  its  own  for  presentation,  but 
stores  the  correct  value  back  out  to  the  file. 

num    info 

short 

Records  the  (a)  number  of  characters  point- 
ed   to    by    the    textptr    for    text    TEXTS 
figures, (b)  value  of  an  attribute  for  attri- 
bute figure  and  (c)  number  of  values  point- 
ed to  by  a  coord  ptr  (e.g.  DIAMOND  has  4 
pts,  thus  8  values  jx&y]). 

figure 

object 

The  object  that  contains  the  figure  associat- 
ed with  the  structure. 

text box 

object 

An     object     containing     a     rectangle     that 
represents  the  area  occupied  by  the  TEXTS 
figure  without  text.  Used  in  page  display. 

textptr 

char 

A    pointer  to   a   text   string   for  a  TEXTS 
figure,  if  present. 

coords 

float 

A  pointer  to  coordinates  of  a  figure,  if  any. 

fwd,  b>vd 

ptrs 

Pointers  to  adjacent  members  of  the  linked 
list. 
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The    last    function    cleans    the    graphics    workstation    for    a   graceful    exit.     The 

functions  of  main  (J  are  as  follows: 

initialise  ()  -  undertakes  all  required  initializations  including  all  texture 
definitions,  line  style  definitions,  devices  for  queue  usage  and  initial  settings 
of  attributes.  Texture  definitions  and  attribute  settings  are  accomplished 
via  calls  to  init  textures()  and  init  attributes()  respectively.  The  actual 
means  of  setting  the  attributes  is  discussed  in  section  5. 

readfontsf)  -  reads  the  current  font  table  into  memory.  The  reading  of  the 
table  occurs  each  time  the  system  is  activated,  ensuring  that  the  most 
recent  font  definitions  are  available  to  the  user  for  the  current  graphics 
printer.  As  the  table  is  read,  the  font  name,  number,  and  size 
characteristics  are  placed  in  arrays  for  future  reference. 

initpopupf)  -  sets  NPSDRAW  to  accept  the  definitions  of  the  various 
menus  throughout  the  program. 

opening  display()  -  welcomes  the  user  to  NPSDRAW  with  the  logo  of  the 
Graphics  and  Video  Laboratory. 

init  guide 0  -  the  system  inserts  the  grids  and  thesis  box  into  the  linked  list 
with  the  appropriate  alignment  acquired  from  the  user  through  a  call  of 
get    user   alignment(). 

There  are  some  general  functions  that  get  called  repeatedly  throughout 

the  NPSDRAW   system's  operation.  They  are  important  throughout  the  entire 

program.  They  are: 

display  positionf)  -  display  the  current  position  of  the  cursor. 

instructionsf)  -  display  up  to  six  lines  of  instructions  on  the  right  hand  side 
of  the  screen. 

redraw  figuresf)  -  redraw  the  current  linked  list  to  one  or  both  buff"ers 

set  orthoviewf)  -  set  the  correct  orthoview  with  respect  to  the  selected  page 
alignment. 
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update  boundsf)  -  update  the  position  of  all  figures,  grids  and  the  thesis 
box  as  a  result  of  input  from  the  arrow  keys  on  the  keyboard.  Permits 
movement  of  the  clipped  image  of  the  page  for  work  on  areas  not  visible. 

set  screenf)  -  update  the  right  hand  side  of  the  terminal  display.  Each 
attribute  setting  is  updated  at  this  time. 

newcursor()  -  select  a  new  definition  of  the  cursor. 

get  hlock()  -  draw  a  block  around  a  specified  area  on  the  drawing  screen. 
This  block  is  used  to  include  figures  for  manipulation  or  represent  the  area 
in  which  a  particular  figure  is  to  be  drawn. 

full  memoryO  -  checks  for  available  memory  before  reading  in  any  figures 
from  memory.    Used  in  both  "read  file"  calls. 

Though  not  a  function,  most  menus  have  an  "Exit"  option.  This  is  used  to  exit 

the  menu  when  work  is  complete. 

2.      Figure  Generation 

The    Main    Menu   can    be   viewed    as   having   four   functional    areas   of 

activity.  The  first  area  is  that  of  Figure  Generation.  That  area  includes  two  menu 

options  that  call  the  functions  fig  menu()  and  line   menu().  Selection  of  an  option 

from  one  of  the  menus  calls  either  draw  a(  type  figure  ),  change (  an  attribute  )  , 

or    editobjf  CHANGEATTRIBUTES    ).    Each    call    to    draw_a(  type    )   calls    the 

function(s)  necessary  for  that  particular  figure  to  be  drawn  as  found  in  Table  3.2. 

Each  drawing  command  contains  a  call  to  insertf)  to  store  the  figure  in  the  linked 

list.  If  a  figure  has  just  been  drawn,  calls  of  reproduce   last()  will  copy  the  last 

drawn  figure  and   permit  placement   anywhere  on   the  screen.  If  the  last  figure 

drawn  is  not  desired,  then  it  is  removed  with  remove   lastf).  Though  the  function 
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edit   obj(  CHANGE  ATTRIBUTES  )  is  accessible  from  fig   menu()  it  is  discussed  later 
in  section  3(d)  as  an  editing  function. 
3.      Editing  Functions 

The  second  functional  area  of  the  Main  Menu  is  that  of  editing  the 
screen  image.  This  includes  moving,  copying,  or  deleting  one  or  more  figures  at  a 
time,  grid  changing,  clearing  the  page  or  viewing  the  page  as  an  undipped  image. 

a.      Single  Edit 

Single  Edit  functions  edit  only  one  figure  at  a  time.  A  figure  is 
selected  from  those  visible  on  the  drawing  area  by  find  figure ()  and  returns  a 
pointer  to  the  structure  containing  that  figure.  A  call  on  find  figure  (J  results  in  a 


TABLE  3.2   FUNCTION  CALLS 
"DRAW   A  (TYPE)" 

Type  Figure 

Function  Call(s) 

RECTANGLE 

draw   rectangle() 

SEED 

insert  seed() 

CIRCLE 

draw   circle() 

ARROW 

draw  arrow  0 

POLYGON 

draw  polygon() 

DL^MOND 

get  block() 
insert  diamond () 

TRIANGLE 

get  block() 
insert   triangle() 

HLINE,VLINE,LINE 

draw   lLne() 

TEXTS 

draw   text() 

MULT  I  LINE 

draw   muiti   line() 

SMOOTHLINE 

draw   smooth   line() 

ARC 

get  circle() 
draw   arc() 

ELLIPSE 

get  block 
insert  ellipse 
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call  to  a  checkf  type  )  for  types  of  arc,  circle,  line  or  text.    The  pointer  then  is 

used  as  input  to  the  subsequent  calls    that  perform  the  actual  editing.  Function 

calls  of  edit   obj(  MOVE  )  permit  the  repositioning  of  any  object.  Once  the  updated 

position  is  determined  through  movement  of  the  object  on  the  screen,  the  function 

modify  ohject()  is  called.  That  function  calls  a  modify  function  unique  for  each 

type  of  figure.  An  edit  mode  of  copying  is  accomplished  through  edit   objf  COPY  ) 

and  performs  similarly  to  MOVE  but  makes  a  duplicate  of  the  figure  for  placement 

on  the  screen  with  duplicate().  Deletion  and  recovery  of  deleted  objects  during  a 

drawing  session  is  performed  by  edit   objf  REMOVE  )  and  edit   objf  RECOVER  ). 

These   simply   change    the    "exists"    field   of  the   structure   drawing    struct    as 

required   by    the   function.    Recovery   is   then   performed   by   drawing   all   figures 

present    in    the    list   with    an    exists   field    of  NO.    Selection   of  these   figures   is 

performed  similarly  to  selection  on  the  current  visible  screen.  Upon  confirmation 

of  a   figure,   the   exists   field   is   changed   back   to   YES.   All   edit   function   calls 

immediately   set   writtenf)  to  FALSE     indicating  the  current   illustration  is  not 

saved.  This  flag  is  only  set  to  TRUE  when  the  illustration  is  saved,  i.e.  written  to 

a  file. 

b.      Block  Edit 

The    Block    Edit    option    selected   from   the   Main    Menu    performs 

operations    similar    to    those    of    Single    Edit    but    on    two    or    more    figures    as 

determined  by  the  rectangle  presented  with    a  call  to  get   blockf).  Once  the  block 

is    placed    by    the    user,    find  objectsf)   traverses    the    linked    list   with    a   set   of 
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coordinates  and  determines  what  if  any  figures  exists  within  the  block.  Existence 
within  the  block  is  determined  with  calls  to  gtlpt  inside (),  Ipt  inside  ()  or 
arc  insidef),  as  appropriate  for  the  specific  figure  type.  Once  the  figure  is 
determined  to  be  within  a  block,  a  pointer  to  it  is  placed  in  a  temporary  array  for 
further  action. 

Movement  of  a  block  in  blockedit()  takes  the  working  array  of 
structure  pointers  and  permits  movement  over  the  drawing  area.  Once  the  block 
of  figures  are  in  the  updated  position,  each  object  undergoes  modify  object()  for 
its  specific  type.  During  movement,  routine  draw  pagef)  is  called  to  show  the 
changing  positions  of  the  figures.  When  blockedit(  COPY  )  is  invoked,  all  actions 
are  similar  to  those  of  MOVE  but  additionally  calls  to  drawcopyf)  and  duplicatef) 
are  made. 

REMOVAL  in  blockedit()  simply  utilizes  the  working  array  of  figures 
found  in  the  block  and  changes  their  "exists"  field  to  NO.  There  is  no  recovery  of 
figures  in  the  blockeditf)  calls  but  each  figure  removed  in  this  mode  can  be 
recovered  through  a  single  edit  function  as  discussed  earlier. 

The   Block    Append   option   is   similar  to   the   Block    Copy   option 

discussed  previously,  but  copies  a  block  from  a  file  rather  than  the  screen.  (The 

method  of  file  identification  is  discussed  later  in  section  3(e).)  All  actions  and  calls 

parallel  the  COPY  sequence.  The  functions  used  are  bblockeditf)  to  coordinate  the 

block  append  of  figures,  bfind  objects()  creates  the  working  array  of  pointers  to 

the  figures  of  a  temporary  linked  list,  bmove  file()  moves  the  new  list  of  figures 
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over  the  drawing  area  as  well  as  lets  the  arrow  keys  move  the  page.  Additionally, 
it  calls  bdraw  page()  which  generates  the  image  of  the  new  figures  for  movement 
about  the  drawing  area.  Once  the  position  of  the  new  figures  is  set,  bmove  page() 
links  up  the  two  separate  linked  lists  into  a  single  entity. 

The  last  option  to  discuss  from  the  Block  Edit  Menu  is  that  of  page 
movement.  The  undipped  version  of  the  page  is  presented  through  a  change  in 
the  viewport  setting  according  to  the  initial  page  alignment.  Once  this  image  is 
present,  the  figures  themselves  are  moved  about  the  screen  via  changes  in  the 
paramters  to  the  function  set  orthview  via  inputs  from  the  arrow  keys.  Once  the 
figures  are  placed  in  the  desired  position,  all  figures  in  the  linked  list  are  taken 
through  modify  objects ()  for  update  of  their  positional  data. 
c.      Grid  Change 

A    grid   overlay   that    provides   a   guide   for    figure   placement    and 

drawing  can  be  varied  with  spacing  of  1/4",  1/2"  or  deselected  altogether.    The 

method   of  changing   the   grid   is   performed   through   a   call   to    toggle ().    When 

NPSDRAW  is  activated,  the  grids  1/4"  and  1/2  "  and  the  thesis  box  are  inserted 

into  the  working  linked  list.  As  the  user  toggles  the  grid,  the  "exists"  field  of  these 

figures  are  changed  to  represent  the  desired  overlay.    The  thesis  box  is  always 

visible,  i.e.  its  structure  "exists"  field  is  always  YES.    The  change  in  the  grid  is 

made  through  the  sequential  changing  of  the  "exists"  fields  of  the  1/2"  and  1/4" 

figures.  Though  the  grid  in  the  1/4"  version  appears  as  one,  it  is  actually  made  up 

of  two  figures  from  the  linked  list,  the  1/4"  and  1/2"  grid  figures. 
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d.      Figure  Attribute  Modification 

The  last  function  that  deals  with  the  actual  editing  of  figures  and 

structures,   is   the  function    editobjf  CHANGE  ATTRIBUTES   ).   This  function   is 

available  through  both  the  Main  and  Figure  Menus.  The  function  call  takes  a 

selected  object  from  find  figure()  and  reads  from  drawing   struct  the  attributes 

associated  with  it  via  alter  attributes().   A  menu  is  displayed  containing  those 

attributes.  The  contents  of  the  menu  items  is  determined  by  reading  the  value 

associated  with  an  attribute  for  that  figure  and  displaying  it  on  the  menu  as  text. 

The  font  text  representation  is  determined  through  use  of  the  font  number  which 

is  used  to  determine  an  array   index.   This  index  then  accesses  the  arrays  that 

contain  the  font  name,  number,  and  size  data.  The  line  width  value  is  acquired 

directly  from  the  structure  while  the  line  style  value  is  converted  to  text  through 

a  case  statement.  Texture  is  not  represented  by  text  since  it  is  visible  on  the 

screen.  All  data  then  is  placed  in  the  menu  as  options  for  change.  Selection  of  any 

menu  option   activates  the  attribute  select  function   associated  with  the  chosen 

attribute.  The  actual  attribute  selection  functions  are  discussed  in  section  3(f). 

Once      the      value      for      the      changed      attribute      is      selected, 

alter   attributes()    selects    the    appropriate    function    of    changefont(),    changelsf), 

changelwf)  and  changetexta().    The  operation  of  each  change  function  is  similar  so 

a  general  description  of  the  procedure  follows.  The  call  to  the  change  functions 

passes   a  pointer  to  the  figure  and  the  new  attribute  value.  The  figure  is  first 

evaluated  if  the  change  is  appropriate.  For  example,  changing  texture  of  a  line 
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does  not  make  sense  so  no  change  occurs  and  the  function  is  terminated.  Two  new 

figures  are  placed  in  the  linked  list,  one  in  front  of  the  selected  figure  for  the  new 

version   and   an   attribute  figure  placed  behind  the  selected  figure  to  reset  that 

attribute    so    following    figures    are    not    effected.    Upon    completion    of    these 

operations,  the  original  figure  is  deleted  from  the  linked  list. 

4.      File  Manipulation 

a.      Read  in  a  File 

Selection  of  the  "Read  File"  option  calls  the  function  read  menu() 

which  presents  the  user  with  a  menu  having  options  of  "Read  File"  or  "View 

Directory".   A  choice  to  read  a  file  activates  get  from  file()  which  prompts  the 

user  for  a  file  name.   While  the  user  inputs  the  name  (visible  on  the  screen  as 

typed), NPSDR AW  waits  for  the  carriage  return  character  as  a  signal  to  evaluate 

the  given  name.  If  the  filename  is  valid  one  of  two  actions  can  occur.  If  no  picture 

is  presently  on  the  screen  (flag  function  drawing   exists  ),  the  file  is  read  into  the 

linked  list  via  file2list().    This  function  calls  individual  functions  for  each  type  of 

figure  for  actual  insertion  into  the  linked  list.  Once  the  file  is  completely  read  in, 

get  from     file  ()  is  terminated.  If  an  image  does  exist  on  the  screen,  the  user  has 

three  options,  to  quit  altogether,  i.e.  to  not  read  the  file,  to  merge  the  screen 

image  with  the  file  picture,  or  to  discard  the  previous  drawing  and  keep  only  the 

file  picture.   The  user  is  provided  a  message  as  to  the  status  of  the  file  name 

provided,    i.e.    "File    Read    Correctly",    or    "File    does    not    Exist"    followed    by 

"returning  to  Menu".   The   get  from  file()  function   also  returns  a  value  to  the 
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calling  function  that  indicates  the  status  of  the  original  read  file  call.  It  is  these 
returned  values  that  determines  the  next  function  call  by  read  menu.  If  the 
returned  value  indicated  that  the  file  existed,  and  was  read  into  the  linked  list, 
set   orthoview(),  redraw  figuresf)  and  set   screen()  are  called  to  finish  the  process. 

Selection  of  the  menu  option  "View  Directory"  or  incorrect  input  of 
a  file  name  calls  a  set  of  directory  functions.  To  exit  this  function,  the  user  needs 
only  to  press  the  middle  mouse  button  to  get  back  to  the  "Read  Menu, 

The  method  described  above  for  reading  in  a  file  is  the  basis  for  the 
previously  described  function  block  append().  The  associated  function  is  that  of 
bget  from  file(). 

b.      Write  File 

The  process  of  writing  a  file  to  disk  is  similar  in  format  to  reading  a 
file.  Upon  selection  of  the  "Write  File"  option  from  the  Main  Menu,  the  user  is 
presented  a  menu  with  selections  of  "Write  File"  and  "View  Directory".  The 
selection  of  "View  Directory"  selects  the  directory  functions  as  described  above 
under  Read    File. 

The   selection   of  "Write   File"    activates   the  function    go   to  file() 

which  then  prompts  the  user  for  a  file  name.    The  file  name  is  checked  against 

present  files  in  the  current  directory.  If  the  name  has  not  been  used,  the  new  file  is 

created  and  the  data  written.  If  the  file  is  found  in  the  directory,  the  user  is  asked 

for  one  of  three  actions  -  to  "0"verwrite,  "A"ppend,  or  "Q"uit.  Each  action  is  self 

explanatory.  The  user  is  provided  with  messages  from  the  system  regarding  the 

48 


status  of  the  file  such  as,  "unable  to  open",  "Writing  to  file",  "Finished  Writing" 
and  "Returning  to  menu".   Upon  completion  of  a  file  write  or  the  selection  of 
"quit"  from  the  menu  level,  the  user  is  returned  to  the  Main  Menu. 
5.      Setting  Attribute  Values 

The  setting  of  the  various  attributes  is  controlled  through  numerous 
short  functions  that  utilize  graphics  system  commands  to  set  the  screen 
representation  of  the  attributes.  The  setting  of  each  attribute  is  done  through  the 
assignment  of  the  attribute  value  to  a  variable.  This  variable  is  read  each  time  a 
new  figure  is  drawn  to  the  screen  and  inserted  into  the  linked  list.  The  functions 
called  are  of  the  form  set   current     (  attribute  )  and  get   current(  attribute  ). 

The  general  operation  of  each  attribute  change  involves  two  steps:  (1) 
get  the  new  attribute  value  and  (2)  assign  that  value  to  the  appropriate  variable. 
All  values  are  provided  by  the  user  through  (a)  selection  of  the  attribute 
description  from  a  menu  or  (b)  selection  of  a  texture  from  a  pallet.  The  values 
returned  from  the  attribute  select  functions  to  the  calling  routine  are  actually 
character  strings.  These  chararacter  strings  are  later  converted  to  numeric  values 
and  used  to  update  a  current  attribute  setting  or  are  used  in  the  modification  of  a 
figure's  attributes. 

a.      Font  Selection 

When    Font   change    is   selected   from    a   menu,   the    first   function 

activated   is  fontsource()  which   returns  a  value   to  signify   the  method  of  font 

selection.  The  options  for  font  selection  are  via  numeric  value  or  style  &z  sizing.  If 
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the  user  chooses  the  numeric  option,  he  need  only  enter  the  desired  font  number 
at  the  system  prompt.  NPSDRAW  checks  the  value  against  range  limits  (0  to 
MAXFONT)  and  then  against  the  "Findex"  array  generated  during  reading  of  the 
font  table  at  system  set  up.  If  the  numeric  value  is  contained  in  this  array,  it  is 
valid  and  a  character  string  representation  of  the  value  is  returned  to  the  caller. 

The  second  option  of  selection  is  more  complex  but  results  also  in 
the  return  of  a  simple  font  number  value.  The  user  first  sees  a  menu  of  all 
available  font  styles  (names)  .  These  names  are  not  dynamically  presented,  i.e. 
they  are  hard  coded  in  the  menu  presentation,  though  easily  modified.  Upon 
selection  of  the  desired  style  or  "No  Change"  (to  save  previous  setting)  the  user 
sees  a  second  menu  of  size  combinations  from  which  the  user  makes  a  selection. 
NPSDRAW  uses  both  values  and  cross  checks  them  with  the  "Fname"  array  for 
name  availability  and  a  matching  size  in  the  CPI  Sz  LPI  arrays.  If  the  user 
selected  combination  is  present,  the  index  value  from  the  arrays  is  used  to 
determine  the  actual  font  number.  This  number  is  then  returned  to  the  caller  as 
a  character  string. 

b.      Texture  Selection 

Values  for  Texture  Selection  are  acquired  through  the  sel  text()  call. 
The  user  sees  a  "Cross  Hair  Symbol"  for  a  cursor  near  the  lower  right  of  the 
screen  for  movement  over  the  various  textures  available  on  the  pallet.  Once  the 
cursor  is  placed  over  the  desired  texture,  selection  is  made  by  pressing  the  Middle 
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Mouse  Button.    If  the  mouse  is  within  an  area  that  defines  a  texture,  a  character 
string  value  is  returned  to  the  caller. 

c.  Line  Style  Selection 

A  call  for  a  Line  Style  change  is  achieved  through  sel  ls()  utilizing  a 
menu  selection  of  the  four  available  line  styles.  Each  line  style  is  described 
textually  for  selection.  The  selection  is  returned  to  the  caller  for  processing  as 
needed. 

d.  Line  Width  Selection 

Line  Width  Selection  (  sel  lw()  )  is  similar  to  Line  Style  selection, 
but  there  are  ten  predefined  line  widths  available  for  selection  through  a  menu. 
There  are  additional  choices  of  "variable"  or  "No  Change".  A  predefined 
selection  returns  a  character  string  value  to  the  caller.  The  option  of  variable  line 
width  is  also  available,  var  lw(J  gives  a  means  for  selection  of  line  widths  in 
0.01"  increments.  The  appropriate  value  is  then  returned  to  the  caller. 
6.      Exiting  The  System 

If  the  last  option  of  the  Main  Menu  is  selected,  the  decision  to  exit  or 
remain  active  is  made  as  a  result  of  the  boolean  response  to  the  function 
check  exit().  This  function  checks  if  a  drawing  exists  with  drawing  existsf)  or  if 
in  fact  the  current  drawing  was  written  to  a  file  by  checking  a  static  variable 
"drawing  written  to  file".  If  no  drawing  exists  or  it  has  been  saved,  then  a 
TRUE  is  returned  to  the  main  menu.  If  the  drawing  was  not  saved,  then  the  user 
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is  prompted  with  a  menu  for  selection  of  options.    Upon  selection  of  exit,  the 
system  is  in  main()  and  final  exiting  of  the  system  occurs  after  a  call  to  cleanupf). 
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IV.    NPSDRAW  :    SOFTWARE  MAINTENANCE 

Maintenance  is  the  work  required  to  be  done  on  a  software  system  after  it  is 
placed  in  operational  use.  This  work  includes  understanding  the  existing  system, 
documenting  the  existing  system,  enhancing  the  capabilities  of  the  system, 
answering  questions  of  users,  training  users,  rewriting  and  restructuring  the 
software  and  adapting  the  system  to  a  new  environment.  All  maintenance  work 
efforts  can  be  categorized  into  three  sub-maintenance  areas:  (1)  CORRECTIVE 
MAINTENANCE  -  maintenance  performed  to  identify  and  correct  software  errors 
and  performance  deficiencies,  (2)  ADAPTIVE  MAINTENANCE  -  maintenance 
performed  to  adapt  the  system  to  changes  in  the  environment  and  (3) 
PERFECTIVE  MAINTENANCE  -  maintenance  performed  to  enhance  the 
capabilities  and  performance  of  the  system.  Regarding  OZDRAW,  maintenance 
efforts  were  of  a  perfective  nature.  Though  corrective  maintenance  was 
performed,  it  is  not  discussed  here. 

No  matter  how  well  a  software  system  meets  the  goals  for  its  design  and 
specification,  it  will  have  to  undergo  some  change  periodically  during  its  lifetime 
to  remain  responsive  to  user  needs.  In  a  study  of  various  large  software  systems, 
M.  M.  Lehman  discussed  various  laws  of  Program  Evolution  that  appeared  to 
recur  through  the   life   cycles  of  programs   [Ref.   3].   The  First  Law  of  Program 
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Evolution  is  the  Law  Of  Continuing  Change  "which  expresses  a  universally 
observed  fact  that  large  programs  are  never  completed.  They  just  evolve".  With 
continuing  observations  and  research  the  the  First  Law  is  now  stated  as: 


A  program  that  is  used  and  that  as  an  implementation  of  its  specification 
reflects  some  other  reality,  undergoes  continual  change  or  becomes 
progressively  less  useful.  [Ref  3.] 

Though  OZDRAW  is  not  a  large  system,  it  still  must  evolve  to  respond  to  the 

user's  needs  through  maintenance.  The  final  product  of  this  maintenance  effort  is 

NPSDRAW. 


A.     MAINTENANCE  FACTORS 

Every  software  product  has  characteristics  that  either  decrease  or  increase  the 
maintenance  effort.  A  partial  grouping  of  these  is  contain  in  Table  4.1.  Those 
characteristics  pertinent  to  the  OZDRAW  system  are  program  complexity, 
number  of  user  reports,  poor  documentation,  good  initial  design  and  lack  of 
experienced  maintenance  individuals. 


TABLE  4.1  SYSTEM  CHARACTERISTICS  THAT  INFLUENCE 

THE  MAINTENANCE  EFFORT 

Increase  Maintenance  Effort 

Decrease  Maintenance  Effort 

System  Age 

Good  Initial  Design 

System  Size 

Modern  Software  Practices 

Program  Complexity 

Automated  Tools 

Number  of  User  Reports 

Data  Base  Management  Techniques 

Application  Type 

Good  Data  Administration 

Poor  Documentation 

Good  Documentation 

Experienced  Maintenance  Personnel 
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To  improve  the  maintenance  effort  of  NPSDRAW  in  the  future,  there  are 
only  two  characteristics  that  can  be  dealt  with  at  the  present:  documentation  and 
a  log  of  user  reports.  There  can  be  no  change  to  program  complexity  or 
improvement  on  the  initial  design,  since  these  factors  are  set  with  the  initial 
version  of  the  system.  The  experience  of  the  personnel  who  will  perform 
maintenance  in  the  future  is  variable  and  most  likely  to  be  influenced  by  their 
expertise  in  the  C  programming  language. 

B.  IMPROVEMENT  OF  DOCUMENTATION 

Maintenance  depends  on  information  about  the  system,  from  design  through 
actual  coding.  Information  must  be  recorded  that  provides  reasons  and 
justifications  for  each  design  decision  and  modification.  Information  must  not  be 
lost  during  the  life  of  a  system.  Information  can  only  be  maintained  through 
quality  documentation. 

Many  situations  exist  where  the  quality  of  documentation  can  be  improved  as 
maintenance  is  performed.  Documentation  can  be  developed  and  maintained  with 
simple  prologues  at  the  beginning  of  a  function.  Data  would  consist  of  author's 
name,  date,  input,  output,  side  effect,  and  exceptions  if  any. 

The  quality  and  careful  design  of  code  is  also  a  part  of  a  well  documented 
system.  A  standard  and  straightforward  coding  style  should  be  be  presented  to 
maintenance  personnel  and  enforced  by  management.  In  the  academic 
environment,  students  generally  code  in  a  style  that  is  similar  to  their  peers,  but 
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minor  variations  of  style  can  have  a  disrupting  and  possibly  confusing  effect  on 
subsequent  personnel.  The  maintenance  personnel  must  have  documentation  that 
can  be  easily  read  and  understood  sufficiently  in  order  to  maintain  the  system.  As 
documentation  improves,  the  program  will  be  easier  to  maintain  in  the  future. 
An  additional  argument  for  good  quality  documentation  is  that  maintenance 
personnel  prefer  using  embedded,  "on  line"  documentation.  As  such,  if  the  "off 
line"  documentation  is  weak  in  any  area,  he  will  tend  to  disregard  all  further 
documentation.  Simple  and  useful  forms  of  documentation  "off  line"  are  plain 
language  explanations  of  functions  and  call  hierarchy  diagrams.  Cross  reference 
listings  of  files  and  functions  are  also  useful  when  tracing  a  program  and 
understanding  its  call  hierarchy.  A  table  listing  indicating  the  callers  and  the 
functions  called  by  a  function  can  be  found  in  Appendix  B. 

C.     PHYSICAL  DIFFERENCES  NPSDRAW  /  OZDRAW 

The  process  of  improving  the  user  interface  of  the  interactive  graphics 
illustrator  has  brought  about  numerous  differences  between  NPSDRAW  and  its 
predecessor  OZDRAW.  These  changes  are  discussed  in  Chapter  V.  Some  basic 
comparisons  may  be  of  interest  at  this  time. 

OZDRAW  was  a  system  of  139  files  (165  functions).  NPSDRAW  has  133  files 
and  (189  functions).  The  difference  in  file  count  is  the  result  of  condensing 
functions  into  common  files.  Though  there  are  a  number  of  new  functions,  the 
actual  code  organization  has  been  changed  slightly.  The  actual  line  count  has 

56 


decreased  almost  3%.  This  is  not  significant  though  and  attributed  to  difference  in 
coding  style  primarily  for  ease  of  changing  repetitious  parameters.  Actual 
increase  in  compiled  code  was  a  little  over  9%,  which  is  not  significant  for  the 
improved  interface  features. 

Overall,  the  diff"erence  between  OZDRAW  and  NPSDRAW  source  codes  is 
primarily  minor  organizational  changes  and  additional  functions.  Future 
maintenance  will  not  be  hindered  by  an  increase  in  the  system  complexity  over 
the  original  version. 
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V.   CONCLUSIONS 

A.     IMPROVED  USER  INTERFACE 

NPSDRAW  follows  the  format  of  its  predecessor  OZDRAW.  If  the  user  is 
experienced  with  OZDRAW,  he  will  notice  the  close  similarity  with  NPSDRAW, 
and  will  notice  numerous  improvements  to  the  user  interface. 

1.  Menu  Presentation  &  Composition 

The  menu  system  now  is  faster  to  traverse  and  perform  related  functions. 
Generally  the  user  is  in  the  second  level  of  menus,  whereas  OZDRAW  required 
the  user  to  move  between  the  third  and  first  level  for  most  related  functions.  The 
user  can  now  access  some  functions  from  multiple  locations  within  the  menu 
structure  rather  than  at  a  single  location. 

2.  Attribute  Display  Area 

The  current  settings  for  the  attributes  line  style,  line  width,  font  and 
texture  are  visible  to  the  user  at  all  times.  Attributes  are  no  longer  identified  by 
an  integer,  but  are  represented  numerically  (line  width,  font),  graphically  (line 
width,  line  style  &z  texture)  and  textually  (font). 

3.  Font  Selection 

There  are  more  than  100  different  characters,  and  special  symbol  font 
definitions  available  to  the  user.  These  are  selectable  via  their  numeric  designation 
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or  through  menu  selection  of  style  and  size  specifications.  The  selected  font  is 
displayed  by  name,  number  and  size  (CPI  and  LPI)  in  the  Attribute  Display  Area 
and  for  the  individual  figure  attributes  when  required.  As  new  font  definitions 
become  available,  simple  miodification  to  a  font  table  provides  immediate  update 
to  the  system  as  the  font  table  is  read  for  each  activation  of  NPSDRAW. 

4.  Texture  Representation  &:  Selection 

NPSDRAW  provides  the  user  with  a  representation  of  the  selected  fill 
pattern  (texture)  as  the  individual  figures  are  drawn  (where  appropriate). 
Additionally,  the  25  different  patterns  are  displayed  in  a  pallet  format  for  easy 
selection.  The  user  no  longer  needs  to  remember  a  unique  numeric  value  for  any 
pattern.  Once  a  pattern  is  selected,  it  is  displayed  as  the  current  setting  in  the 
Attribute  Display  Area.  Screen  representations  are  unlimited,  selections  are 
limited  by  the  printer  utilized  in  drawing  the  final  illustration. 

5.  Line  Style  and  Line  Width  Representation  h  Selection 

The  current  line  style  and  line  width  selections  are  displayed  attribute 
settings  in  the  Attribute  Display  Area.  The  line  styles  remain  the  same  (limited 
by  the  printer)  but  line  widths  are  selectable  from  0.01  to  0.1  in.  Line  width  on 
the  screen  is  proportional  to  the  grid  dimensions  while  the  numeric  value  shown  is 
the  size  of  the  printed  line.  The  current  line  style  is  displayed  within  the 
Attribute  Display  Area.  The  line  widths  are  selected  from  a  menu  containing 
preset  values  and  as  the  capability  of  the  printer  changes,  a  variable  scale 
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selection  is  provided  for  selection  of  widths  0.10  to  1.00  inches.  Line  styles  are 
textually  listed  for  selection. 

6.  Figure  Attribute  Change 

A  figure's  attributes  can  be  changed  from  the  Main  or  Figure  Menu.  The 
selected  figure's  attributes  are  presented  in  a  menu  for  viewing  or  selection  of 
change.  A  particular  attribute  change  can  selected  in  the  same  manner  as  current 
settings  are  selected. 

7.  Geometric  Figures  Available 

Though  all  geometric  figures  were  available  through  various  drawing 
primitives  in  OZDRAW,  two  of  the  more  common  figures,  the  DIAMOND  and 
TRIANGLE,  were  added  to  its  predefined  figures.  Previously,  the  polygon 
function  or  single  line  functions  were  used  to  construct  these.  They  are  now 
available  as  primitives. 

8.  Smooth  Line  Generation 

Within  the  Line  Menu,  a  facility  for  drawing  a  free  form  line  has  been 
added.  This  facility  provides  the  capability  for  enhancing  drawings  with  smooth 
curved  lines  or  cursive  writing  formats. 

B.     NPSDRAW  LIMITATIONS 
1.      Font  Representation 

The  IRIS  has  the  limitation  of  only  a  single  font  displayable  on  the 
terminal  monitor.  This  font  has  the  style  of  San  Serif  and  approximate  sizing  of  6 
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LPI  and  10  CPI.  As  the  user  selects  different  styles  and  sizes,  the  characters  on 
the  screen  remain  the  same.  Even  with  the  proportioned  red  box  surrounding  the 
text,  this  becomes  annoying  and  somewhat  messy  as  the  complexity  and  amount 
of  text  in  the   picture  increases. 

A  related  font  problem  is  the  representation  on  the  screen  of  the  special 
symbols  available  with  numerous  font  selections.  The  special  symbols  must  be 
displayed  on  the  picture  as  standard  keyboard  characters  and  symbols.  Utilizing 
the  special  symbols  requires  the  user  to  have  a  "translation  table"  at  hand  when 
entering  text  onto  the  picture.  At  present,  the  final  picture  can  only  be  "proofed" 
through  review  of  a  printed  image. 

2.  Scaling 

As  with  any  drawing  process,  it  is  easier  to  draw  a  figure  in  a  larger 
format  where  slight  errors  of  alignment  are  harder  to  notice.  Special  figures  may 
be  needed  in  various  sizes  for  placement  on  different  pictures.  A  facility  to  permit 
the  scaling  of  individual  or  groups  of  figures  (blocks)  would  provide  a  greater 
flexibility  in  drawing  a  high  quality  picture.  Details  in  a  large  figure  need  to  be 
maintained  as  the  figure  is  reduced.  A  single  drawing  of  a  special  figure  could 
then  be  kept  in  the  user's  library. 

3.  Alignment 

Consistency  of  figure  size  between  similar  figures  is  easily  maintained  by 

duplication  of  the  first,  either  through  the  copy  utility  immediately  after  being 

drawn  or  through  the  utilities  in  single  or  block  edit  modes.  The  problem  that 
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arises  is  the  positioning  of  these  figures  with  reference  to  a  particular  plane  or 
point  on  the  page.  Each  figure  can  be  positioned  if  the  user  moves  the  mouse 
slowly.  Proximity  of  the  figure  with  others  determines  the  visible  accuracy  of  the 
alignment  process. 

A  related  problem  is  the  placement  of  line  end  points  and  arrowhead 
positioning  at  a  specified  boundary.  Dependent  on  the  line  widths  and  styles  of 
the  figures  and  lines,  precise  setting  of  the  end  points  of  a  line,  or  the  position  of 
an  arrowhead  becomes  difficult. 
4.      Text  Placement 

As  the  user  types  in  a  text  string,  it  is  placed  on  the  picture  in  a  left  to 
right  fashion.  For  any  picture,  the  text  can  only  be  placed  horizontally,  depending 
on  the  selection  of  landscape  or  portrait  page  orientation.  The  user  therefore 
cannot  draw  a  picture  in  the  landscape  mode  and  have  the  page  number  placed  in 
a  portrait  orientation. 

Multiple  lines  of  text  cannot  be  generated  automatically  with  the  line 
feed  and  carriage  return  actions.  Each  line  must  be  placed  by  the  user,  with  the 
exactness  of  placement  left  up  to  his  experience.  The  provision  of  the  ability  to 
automatically  place  text  would  provide  a  level  of  quality  for  more  textual  oriented 
figure  displays. 
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C.     AREAS  FOR  FUTURE  MODIFICATION 

As  with  all  systems,  there  can  always  be  improvements  or  enhancements  to 
maintain  their  usefulness.  For  local  usage  by  students,  faculty  and  staff, 
NPSDRAW  is  more  than  sufficient  at  this  time.  Demand  will  require  that  it  be 
modified  further  to  maintain  competence  with  commercially  available  systems. 
Below  are  listed  various  areas  for  future  research  and  modification. 

1.  Scaling 

When  a  user  designs  a  custom  figure  for  a  project,  he  undoubtedly 
desires  to  use  that  figure  at  a  later  date.  Just  the  fact  that  it  is  a  special  figure, 
means  that  it  has  more  than  a  single  primitive  component  in  it.  This  gives  rise  to 
the  need  for  a  "Block  Scaling"  option  in  the  system.  With  this  feature  available, 
the  user  could  draw  an  original  figure,  and  refine  each  component  as  the  overall 
picture  takes  shape.  This  would  make  the  system  performi  as  a  drawing  "in 
pencil"  available  for  simple  modifications  rather  than  "in  ink"  where  each  figure 
would  need  erasure  before  change  in  size. 

2.  Rotation 

Along  with  scaling  features,  a  feature  to  permit  rotation  of  figures  would 
be  a  nice  addition.  Presently,  using  primitives  built  into  the  system,  the  user  can 
draw  most  figures  required  with  little  difficulty.  But  positioning  of  those  figures 
requires  a  sketch  of  the  picture  beforehand  to  derive  the  general  positions  on  the 
drawing  page.  Furthermore,  the  user  draws  two-dimensional  images. 
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Though  simple  three-dimensional  drawing  is  not  altogether  difficult.  NPSDRAW 
would  be  enhanced  and  simplified  even  more  so  with  a  rotation  capability. 

3.  Fixed  Point  Drawing 

"Fixed  Point  Drawing"  is  used  here  to  describe  drawing  of  figures  that 
are  centered  on  or  have  a  predefined  common  point.  Additionally  it  may  include 
restrictions  on  the  drawing  area  defined  by  the  user  during  drawing  of  sequential 
figures.  It  would  be  a  multi-function  facility.  Functions  available  could  be  (l)  the 
user  defines  a  point  that  is  conomon  to  selected  figures,  such  as  a  set  of  concentric 
circles.  (2)  A  limit  could  be  set  dynamically  on  the  cursor  preventing  movement 
outside  a  specified  area,  implemented  in  similar  manner  as  the  vertical  and 
horizontal  line  drawing  restriction. 

4.  Insertion  of  a  Bitmap  Image 

A  bitmap  image  insertion  capability  is  a  necessary  addition.  There  are 
images  that  one  cannot  make  on  NPSDRAW,  i.e.  figures,  that  can  be  generated 
and  copied  from  a  graphics  terminal  via  a  bitmap  dump.  The  ability  to  include 
such  a  picture  on  the  drawing  area  where  the  user  can  annotate  specific  points 
would  provide  a  high  quality  product  that  currently  can  only  be  acquired  through 
a  strictly  manual  figure  illustration  system. 

5.  Point  Modification 

As  the  user  develops  his  skill  with  NPSDRAW,  he  begins  to  make  more 

complicated   figures  to  meet  his  needs.   In  the  course  of  drawing,  some  figures 

require  the  modification  of  a  specific  point  of  a  figure,  i.e..  the  corner  of  a  polygon 
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or  the  end  point  of  a  line  segment.  The  current  method  is  to  erase  the  current 
figure  and  redraw  it  as  necessary.  If  the  user  could  have  the  ability  to  move  a 
single  point  of  a  figure,  the  modifications  could  be  done  in  a  relatively  short  time 
as  compared  to  redrawing  the  complete  figure. 

D.     CONCLUSION 

NPSDRAW  was  designed  to  be  a  system  accessible  by  unskilled  users  who 
needed  a  quick,  easy  method  for  generating  illustrations.  The  system  is  intuitive 
in  its  operation.  It  still  produces  a  high  quality  product  that  can  be  easily 
modified  and  reproduced.  The  NPSDRAW  system  is  considered  a  medium  sized 
program  (at  less  than  15000  lines)  and  thus  easily  accepts  system  modification 
and  performance  enhancement.  The  limitations  and  future  modifications 
discussed  above  are  by  no  means  conclusive.  As  NPSDRAW's  users  community 
grows,  so  do  we  expect  demands  for  the  program's  expansion  and  modification. 
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APPENDIX  A 


NPSDRAW  WITH  THE  QMS  1200  LASER  GRAPHIC  PRINTER 

This  supplement  to  the  NPSDRAW  users  manual  is  provided  to  illustrate  the 
various  attributes  available  with  the  QMS  Laser  Printer,  and  to  identify  system 
peculiarities. 

Attributes 

NPSDRAW  uses  the  following  attributes  available  on  the  QMS  laser  printer: 

(1)  Four  linestyles, 

(2)  Ten  linewidths, 

(3)  25  textures  (fill  patterns)  and 

(4)  111  fonts. 

An  example  of  each  attribute  is  shown  later  in  this  supplement.  When  using 
various  combinations  of  attributes  and  primitives,  unexpected  results  appear  on 
the  drawing  area  and  the  printed  page.  When  drawing  circles  or  ellipses  with 
other  than  a  solid  line,  the  image  will  not  appear  on  the  screen  until  the  radius 
and  minor  axis  exceed  1.25"  for  large  dashed  lines,  1.0"  for  medium  dashed  lines 
and  0.5"  for  the  dotted  lines.  If  a  primitive  is  drawn  under  such  conditions,  only 
through  actual  printing  of  the  product  can  it  be  seen.  Though  the  image  is 
present  on  the  screen,  the  large  linewidths  imposed  on  the  broken  line  will  render 
a  printed  image  with  a  "scalloped"  edge.  Examples  of  this  aberration  are  shown 
with  the  various  linewidths  and  styles  in  this  appendix. 

OZPRINT 

The  utility  for  printing  the  NPSDRAW  figure  files  is  OZPRINT.  This  print 
program  is  a  driver  for  the  FIGURE  illustration  system.  OZPRINT  parses  the 
parameters  and  spawn  the  background  process  to  print  the  picture. 

The  method  to  print  a  file  produced  by  NPSDRAW  is  to  issue  the  following 
command: 

ozprint  -alignment  filename  [-alignment  filename] 

where  alignment  is  *h'  for  horizontal  (landscape)  and  V  is  for  vertical  (portrait). 
More  than  one  file  can  be  printed  in  this  manner,  as  long  as  the  correct  number 
of  alignment  values  are  placed  in  the  appropriate  positions. 
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A  source  of  error  is  calling  OZPRINT  twice,  or  more,  in  rapid  succession.  This 
error  is  caused  by  FIGURE  using  a  scratch  file  to  store  intermediate  data.  With 
more  than  one  process  executing  at  a  time,  collisions  over  this  scratch  file  may 
occur.  To  avoid  this,  wait  between  calls  to  print  OZDRAW  figures.  This  potential 
trouble  area  can  be  avoided  with  a  compound  call  to  the  OZPRINT  utility. 

Calling  OZPRINT  with  the  incorrect  page  alignment  for  the  current  file,  can 
produce  unexpected  results,  especially  if  the  picture  extends  beyond  the  page 
boundaries  in  a  particular  orientation.  Page  orientation  is  notS  encoded  in  the  file. 

The  Seed  Point 

When  a  seed  point  is  dropped,  it  will  fill  the  enclosed  area  with  the  currently 
set  texture.  If  the  area  is  not  enclosed,  it  will  fill  to  the  page  boundary.  The  seed 
point  will  not  be  printed. 

Drawing  a  Filled  Figure 

When  assigning  a  texture  to  a  figure  there  are  considerations  to  be  made:  (1) 
Due  to  the  polygon  fill  algorithm  used  in  OZPRINT,  only  a  concave  figure  can  be 
filled.  The  fill  pattern  is  unpredectable  when  there  are  overlapping  figures  with 
diff'ernet  textures  and  neither  being  clear.  Attempts  to  fill  a  polygon  with  a 
segment  of  concave  border  can  also  induce  undesirable  results.  (2)  Filling  a  figure 
with  other  than  a  solid  boundary,  will  extend  the  texture  beyond  the  boundary  to 
the  next  solid  boundary  or  edge  of  the  page.  (3)  Overlapping  figures  with  other 
than  identical  textures,  will  only  be  filled  with  a  single  texture. 

Picture  Overrun 

OZDRAW  does  not  perform  ajiy  clipping  of  figures  that  extend  beyond  the 
page  boundary.  This  is  important  to  consider  since  figures  can  be  inadvertently 
moved  off"  the  page  and  stored  in  a  file.  Printing  such  images  produces  undesirable 
results.  The  printing  system  will  accept  the  files  with  errors.  The  QMS  will  handle 
overrun  to  the  right  and  top  of  the  page,  but  cannot  control  the  left  or  bottom 
margins. 
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FONTS  AVAILABLE 

Arabic  /  Keyboard  Characters 

Style    LPI/CPI 

3/5 
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8/12 
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Roman  Slanted 

X 
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Roman  Underlined 

X 

X 

X 

X 

Roman  Title 

X 

X 

Roman  Bold  Title 

X 

X 

San  Serif* 

X 

X 

X 

X 

X 

San  Serif  Bold 

X 

X 
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X 
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San  Serif  Italic 
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Orator 

X 

*  Additional  San  Serif  of,  8/14  ,  8/25,  12/25. 

Special  Purpose  Characters  /  Letters 

roM  Roman 

X 

X 

X 

Supplemental  Roman 

X 
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Supplemental  Roman  Bold 

X 
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Supplemental  Roman  Slanted 

X 

X 
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Supplemental  San  Serif  Bold 

X 
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Scientific 
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Scientific  Title 

X 

X 

DEC  Technical  Font 

^ 

X 
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DEC  Technical  Title  Font 

X 

X 

DEC  Symbol 

X 

X 

Math  Symbol  (mo) 

X 

X 

Math  Symbol  (mt) 

X 

X 

APL 

X 

X 

X 

Font  Styles  and  Sizes 
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APPENDIX  B 

FUNCTION  &  FILE  REFERENCE 

The  following  pages  are  provided  for  easy  reference  of  each  file,  its  functions 
and  general  operation  as  well  as  the  location  of  each  function.  The  functions  listed 
are  only  those  written  for  NPSDRAW,  i.e.  does  not  include  any  system  functions. 
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1.    FUNCTION  TO  FILE  CROSS  REFERENCE 

I'iles  -  Functions                                                                | 

File  Name 

Function  Name 

Operation 

Ipt    inside. c 

one   pt  inside() 

To  view  a  certain  type  of  figure  that  is 
uniquely   defined   by   one  point,  and   to 
see  if  it  lies  inside  a  given  rectangle. 

align. c 

get   user  alignment() 

To  prompt  the  user  for  page  alignment. 

alter. c 

alter  attributes() 

To  get  the  users  values  to  change  and 
call  the  appropriate  functions. 

angle.c 

get_angle() 

To  calculate  the  angle  that  the  second 
point  makes  with  the  first  point  and  the 
horizontal.  Used  in  drawing  arcs. 

arc.c 

draw   arc() 

To  draw  an  arc  and  insert  it  into  the 
list. 

arc2fnl.c 

arc   to  file() 

arc2list() 

barc21ist() 

(1)  To  write  the  arc  definition  to  a  file, 

(2)  to  read  an  arc  definition  from  a  file 
into  the  working  linked  list  and  (3)  to 
read  an  arc  definition  from  a  file  into  a 
temporary  linked  list  for  block  append. 

arc    inside. c 

arc   inside() 

To  determine  if  a  given  arc  is  inside  a 
given  rectangle. 

arrow,  c 

draw  arrow  0 

To  draw  an  arrow 

bad.c 

bad   data() 

To   inform    the   user   that   there   is   bad 
data  in  the  file  being  read  in. 

bfile21ist.c 

bfile21ist{) 

To  read  a  file  and  insert  the  drawing  in 
the  temporary  block  linked  list  used  in 
block  append. 

binsert.c 

binsert   into  list() 

To  insert  the  figure,  with  its  associated 
data  into  the  block  linked  list. 

blockedit.c 

blockedit()        bblock- 
edit() 

move  picked  objs() 
bmove  file() 
draw    page() 
bdraw   page() 
find   objects 0 
bfind   objects()    copy- 
block  ()  draw  copy() 

Functions  used  in  Move  a  Block,  Copy 
a  block  and  Block  Append. 

border. c 

get   bottom() 

set   bottom() 

get   left()        set   left() 

update   bounds() 

To   manage   the   values  that  allow   the 
page    to    be    moved    up    and    down,    or 
across.    These  values  represent  the  bot- 
tom or  left  values  of  the  ortho  call. 

bread. c 

bget  from   file() 

The  driver  function  for  block  append  - 
read  a  drawing  in  from  file  and  attach 
to  cursor  for  positioning. 
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File  iName 

Function  IName 

Operation 

change. c 

change() 

To  input  new  values  for  the  current  set 
attributes 

changefont.c 

changefont() 

To  alter  the  font  of  a  chosen  text  string. 

changels.c 

changels() 

To  alter  the  linestyle  of  a  chosen  figure. 

changelw.c 

changelw() 

To    alter    the    linewidth    of    a    chosen 

• 

figure. 

changetexta.c 

changetexta() 

To  alter  the  texture  of  a  chosen  figure. 

check   figure. c 

check   arc() 
check   circle() 
check   line() 
check   text() 

Determines   whether   a  chosen   point   is 
near  the  control  point  of  a  figure. 

circle.c 

draw  circle() 

To  draw  a  circle  given  a  start  point  and 
insert  it  into  the  linked  list. 

circle2fnl.c 

circle   to   file() 

circle2list() 

bcircle21ist() 

(1)  Writes  a  circle  definition  to  a  file  (2) 
writes  a  circle  definition  into  the  work- 
ing  linked   list   and    (3)   writes   a  circle 
definition   into  a  temporary    linked   list 
for  block  append. 

clean   list.c 

clean   list() 

clean   linestyle() 

clean   font() 

clean   texture() 

check    1st   not   default() 

Removes   attributes   from   the   list   that 
are  unused. 

cleanup  .c 

cleanupO 

To  exit  the  system  and  reset  all  values. 

clearpage.c 

clearpage() 

Reset  the  list  so  no  user  drawings  exist. 

copy  last.c 

reproduce  last() 

Copy  the  last  figure  in  the  linked  list 

copy   obj.c 

copy   obj() 

To   move    the   picked    figure   to   the   re- 
quired position  to  copy  it. 

correct. c 

check   correct() 

To   check   that   the   chosen   figure   is   in 
fact  the  figure  that  the  user  intended  to 
pick. 

current. c 

init   attributes() 
set   real   Iinewidth() 
get   real   Iinewidth() 
set  current   linewidth() 
get   current   linewidth() 
set   current   texture() 
get   current   texture() 
set   current   font() 
get   current   font() 
set   current   !inestyle() 
get   current   linestyle() 

These    functions    manage    the    variables 
that  are  the  current  state  of  the  attri- 
butes. 

cursor. c 

,  newcursor() 

Changes  the  cursor  definition  and  turns 
on  the  new  cursor. 
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FUe  Name 

Function  JName 

Operation 

dirdraw.c 

dirdraw()             dir- 
scroll() 

This  subroutine  queries  the  user  to  ac- 
cess an  external  file  and  load  it  into  the 
Init   global  structure.   Additional  scrol- 
ling  menu   added   to   the  Mike   Gaddis 
Directory  package 

display   pos.c 

display   position() 

To  display  the  position  'of  the  cursor  in 
page  coords  ie  8.5x11" 

dist.c 

distance   between() 

To  calculate  the  distance  between  two 
points. 

draw.c 

draw   a() 

The   driver   for   drawing  all   the   primi- 
tives available. 

draw    erased. c 

draw   erased  0 

To  draw  the  page  displaying  only  those 
figures  that  have  been  erased. 

duplicate. c 

duplicate() 

To  duplicate  the  required  figure 

edit    menu.c 

edit   menu 
block   edit() 

To  display  the  edit  or  block  edit  menu 
and  get  the  users  selection 

edit    obj.c 

edit_opj() 

To   be  the   "driver"  for  the  single  edit 
functions. 

ellipse2fnl.c 

ellipse   to   file() 

ellipse21ist() 

bellipse2list() 

(l)To  write  an  ellipse  definition  to  file, 
(2)  To  read  an  ellipse  definition  from  a 
file  and  insert  into  the  working  linked 
list  and  (3)  To  read  an  ellipse  definition 
from  a  file  and  insert  into  a  temporary 
linked  list. 

exit.c 

check   exit() 

Check  if  the  user  wishes  to  exit  without 
saving  the  picture. 

fig    menu.c 

fig  menuO 

To  display  the  figure  menu  and  get  the 
user's  selection. 

file21ist.c 

file21ist() 
get   next() 

To  read  a  file  and  insert  the  drawing  in 
the  working  linked  list. 

find.c 

find   figure() 

To  find  if  a  figure  exists. 

font2fnl.c 

font   to  file() 

font21i3t() 

bfont21ist() 

(1)    Write  the  font  value  to  a  file   (2) 
read   the  font  value  from   a  file  to  the 
working  list  and  (3)  read  the  font  value 
from  a  file  into  the  working  temporary 
linked  list 

font   size.c 

font  size() 

To  calculate  the  size  of  the  red  box  to 
be   placed   around   text   to  indicate  the 
different  size  of  the  font. 

fontsource.c 

fontsource() 

To   get   the   font   selection   source   from 
the    user    i.e.    by    numeric    value   or   by 
selection  of  style  and  size 

full.c 

full    memory 0 

To  flag  the  user  that  he  has  filled  up  all 
available  memorv. 
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File  JName 

Function  JName 

Operation 

get    dir.c 

get  directoryO 

To    call    M    GADDIS's    directory    func- 
tions. 

getblock.c 

get   block() 

To  get  the  coords  for  a  rectangle  that 
inscribes  an  area  for  figure  selection. 

getcircle.c 

get  circle() 

To  get  from  the  user  a  circular  section 
of  the  screen.  The  center  point  has  al- 
ready been  determined,  now  all  that  is 
needed  is  the  radius. 

getlist.c 

getlistO 

Get  the  listing  for  the  directory 

getq.c 

get  queue() 

Steve  Firths  idea  of  a  queue's  operation 

graphlab.c 

graphlabQ 

It  is  the  logo  for  the  NPS  Graphics  and 
Video  Laboratory 

gtl    inside. c 

gtlptinside() 

To  see  if  a  certain  class  of  figures  that 
has  many  points,  lies  within  a  region. 

init.c 

initialise() 

Undertake  all   required  initialization  of 
variables  and  settings  for  NPSDRAW. 

init   guides. c 

init  guides() 

Inserts  four  structures  into  the  working 
linked   list   that   represent   the  grids   &; 
thesis  box  -  guides  on  the  drawing  area 

init    textures. c 

init   textures() 

Initialization  of  all  possible  textures.  All 
texture  definitions  are  kept  here. 

insert. c 

insert   into  list() 

The  driver  that  inserts  all  figures  with 
data  into  the  working  linked  list. 

insert   arc.c 

insert  arc() 
binsert  arc() 

Takes  all  arc  relevant  information  and 
inserts  it  into  either  the  working  linked 
list    or    the    temporary    linked    list    for 
block  append. 

insert    ell.c 

insert  ellipse() 
binsert  ellipse() 

Takes  all  ellipse  data  and  inserts  it  into 
the  working  linked  list  or  the  temporary 
linked  list  for  block  append. 

insert   poly.c 

insert  diamond() 
insert   triangle() 

Takes  diamond  or  triangle  data  and  in- 
serts it  into  the  working  linked  list  from 
a  drawing  sequence.  Not  used  for  file  to 
list  or  block  append  since  in  files  they 
are  referred  to  as  polygons  only. 

inside. c 

inside() 

To  see  if  a  particular  given  point  lies 
within     a    given     rectangle.     Used     for 
selecting    "rectangle"    prompts    on    the 
screen. 

instruct. c 

instructions() 

To   display    the   function   of  the   mouse 
buttons  and  keys. 

invalid. c 

invalid   entry() 

To  flag  to  the  user  that  the  entry  he  has 
entered    to   change   an    attribute   is    in- 
valid. 
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i?  lie  JName 

f 'unction  I\ame 

Uperation 

line.c 

draw   line() 

To   draw   a  single  line  given   the  start 
point. 

lme2fnl.c 

line  to  file() 

line21ist() 

brme21ist() 

(1)  To  write  a  line  to  a  file  (2)  To  read 
a    line    definition    from   a   file    into    the 
working   linked   list  and   (3)   to   read  a 
line  definition  from  a  file  into  the  tem- 
porary linked  list  for  block  append. 

line   menu.c 

line   menu() 

To  prompt  the  user  for  the  various  lines 
that  can  be  drawn  via  a  menmi  selection 

line   size.c 

line  size() 
lw2pix() 

To  map  the  set  linewidth  a;ttrilbi!ite  to 
the  real  linewidth  and  map  the  chosen 
linewidth  to  a  number  of  pixels  out  the 
screen. 

list2file.c 

list   to  file() 

The  driver  that  controls  the  storage  of 
all  existing  figures  to  the  file. 

ls2fnl.c 

linestyle  to  file() 

linestyle21ist() 

blinestyle21ist() 

(1)  to  write  a  line  style  to  a  file,  (2)  to 
read   a   line   style  from  a   file   into   the 
working   linked  list  and  (3)   read  a  line 
style  from  a  file  and  into  the  temporary 
linked  list  for  block  append. 

lw2fnl.c 

linewidth   to  file() 

linewidth21ist() 

blinewidth21ist() 

(1)  to  write  a  line  width  to  a  file,  (2)  to 
read   a  line  width  from  a  file  into  the 
working  linked  list  and  (3)   read  a  line 
width    from    a   file   and   into  tke   tem- 
porary linked  list  for  block  append. 

main  menu.c 

nnain   menu() 

To  display  the  main  menu  andi  get  the 
users  selection. 

map.c 

nnapO 

nnap  to  list() 

To  map  from  page  to  screen  coords  and 
vice  versa. 

mod   arc.c 

modify   arc() 

To  change  the  position  of  a  given  arc  by 
the  given  amount  without  changing  its 
attributes. 

mod   circle. c 

modify   circle() 

To  move  the  chosen  circle  by  the  given 
amount. 

mod   ellipse. c 

modify   ellipse() 

To  change  the  position  of  a  given  ellipse 
by  a  given  amount  without  changing  its 
attributes 

mod   line.c 

modify   line() 

To  change  the  position  of  a  given  line 
by  a  given  amount  without  changing  its 
attributes. 

mod    obj.c 

modify   object () 

To  select  the  given  function  to  move  the 
chosen  figure. 

mod    poly.c 

modify   polygon() 

To  change   the   position  of  a  given   po- 
lygon a  given  amount  without  changing 

its  attributes. 
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tile  JName 

Function  iName 

Operation 

mod    seed.c 

modify   seed() 

To  change  the  position  of  a  seed 

mod   text.c 

modify   text() 

To  change  the  position  of  a  given  text 
string  a  given  amount  without  changing 
any  of  its  attributes. 

move   obj.c 

move  obj() 

To  move  an  object  on  the  page. 

move   page.c 

move  page() 

To  reduce  the  page  so  it  can  be  seen  in 
its  entirety  and  allow  the  user  to  move 
all  the  figures  in  one  motion. 

multi  Ime.c 

draw  multi   line() 

Draw    continuous    lines    ,    i.e.    adjoined 
non   parallel  segments. 

npsdraw.c 

main() 

The  driver  for  the  illustrator  system. 

not    found. c 

not  found 0 

To  inform  the  user  that  when  he  chose 
an  object  for  editing  the  cursor  was  not 
close  enough. 

poly2fnl.c 

poly   to  file() 
polygon2list() 
bpolygon2list() 
do  rectangle() 
bdo  rectangle() 
do  polygon() 
bdo  polygon() 

(1)   To  write  a  polygon  definition  to  a 
file   ,   (2)   to   read   a   polygon   definition 
from  a  file  into  the  working  linked  list 
and   (3)   to  read  the  polygon  definition 
from  a  file  into  the  temporary  linked  list 
for  block  append. 

polygon. c 

draw   polygon() 

To    draw    a    polygon    given    the    start 
point. 

poputil.c 

initpopupO      pop- 
up()  showpopupO 

(1)  Initialize  the  system  for  use  of  the 
popup   menu   system,    (2)    generate   the 
menus  and  get  the  users  selection,  and 
(3)  show  the  menus. 

printable. c 

printable() 

To   calculate   if  a   value   is   a   printable 
ASCII  character. 

read.c 

get  from   file() 

The  driver  function  to  read  a  drawing  in 
from  file. 

read   menu.c 

read   menu() 

Displays    the    read    menu    and    get    the 
users  selection. 

readfonts.c 

readfonttable() 
index2ftable() 

(1)   Read  the  font  table  and  fill  arrays 
with  the  data,  (2)  Take  a  font  number 
and  find  the  index  to  its  data  in  the  ar- 
ray. 

rectangle.c 

draw   rectang]e() 

Draws  a  rectangle  given  the  start  point. 

redraw. c 

redraw    figures() 

Redraw     the     complete     picture     from 
linked  list  to  one  or  both  buffers. 

remove. c 

remove   last() 

To  remove  the  last  chosen  drawn  figure. 
e.g.  remove  the  last  drawn  circle  when 
circles  are  selected  as  the  primitive  to 
be  drawn. 
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function  Name 

Operation 

seed.c 

insert   seed() 
binsert  seed() 

(1)  Insert  a  seed  into  the  working  link 
list  and  (2)  insert  a  seed  into  the  tem- 
porary linked  list  for  block  append. 

seed2fnl.c 

seed   to   file() 

seed21ist() 

bseed21ist() 

(1)  To  write  the  seed  definition  from  the 
list  to  a  file,  (2)  to  write  the  seedpoint 
definition  from  a  file  into  the  working 
linked  list  and  (3)  to  write  the  seedpoint 
definition  from  a  file  into  the  temporary 
linked  list  for  block  append. 

sel   font.c 

select   font() 

To  get  the  user  font  selection. 

sel   Is.c 

select   ls() 

To  get  the  user  line  style  selection. 

sel  Iw.c 

select   lw()  var  lw() 

To  get  the  user  line  width  selection. 

sel   text.c 

select-text  () 

To  get  the  user  texture  selection. 

sensible. c 

not   sensible() 

To  flag  to  the  user  that  he  has  tried  to 
alter  an  attribute  of  a  figure  that  does 
not  make  sense.  For  example  changing  a 
texture  of  a  text  string  would  be  useless. 

set.c 

set  orthoview() 

To  set  the  ortho  and  viewport  for  the 
correct   alignment    so   the   page  can   be 
drawn. 

set    fname.c 

set   filenanne() 

To  display  the  filename  of  the  file  read 
in  on  the  top  right  corner  of  the  screen. 

set    mouse. c 

set   mouse() 
restrict   mouse() 
reset   mouse() 

Various    functions    to    manipulate    the 
mouse.  The  last  two  functions  are  used 
by  the  line  functions  to  force  the  mouse 
to  be  either  horizontal  or  vertical. 

setnewscrn.c 

set   screen() 

To  set   up  the  right   hand   side  of  the 
screen. 

smoothline.c 

draw  smooth   line() 

To  draw  a  smooth  continuous,  cursive 
style  line. 

store   alignment. c 

set  alignment() 
get   alignment() 

To  store  and  manage  the  value  of  page 
alignment. 

syntax. c 

syntax   error() 

To  flag  to  the  user  that  one  of  the  op- 
codes   read    in    from    the    file    was    not 
recognized. 

text.c 

draw   text() 

insert   hdgl() 

replace   hdgl   w   hdg2() 

Draws    text    given    the    starting    point. 
The  headings  are  instruction  boxes  that 
appear  on  the  screen. 
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File  Pslame 

Function  IName 

Operation 

text2fnl.c 

text   to  file() 

text21ist() 

btext21ist() 

(1)    To    write    a    text    string    from    the 
linked  list  into  a  file  (2)  to  write  a  text 
string  from  a  file  to  the  working  linked 
list  and  (3)  to  write  a  text  string  from  a 
file    to    the    temporary    linked    list    for 
block  append. 

texture2fnl.c 

texture  to   file() 

texture21ist() 

btexture21ist() 

(1)   To  write  a  texture  value  from  the 
linked  list  into  a  file  (2)  to  write  a  tex- 
ture  value  from   a   file   to   the  working 
linked  list  and  (3)  to  write  a  text  value 
from  a  file  to  the  temporary  linked  list 
for  block  append. 

toggle.c 

toggle_grid() 

To    toggle    the    grid    overlay    that    is 
displayed  on  the  screen. 

view   page.c 

view  page() 

To   allow   the   user   to   view   the   entire 
page  undipped  at  a  reduced  scale. 

welcome. c 

opening  display() 

To    display    the    opening    banner    page 
with  logo. 

width2lwTaum.c 

width21wnum() 

Return  the  attribute  value  of  the  passed 
real  linewidth. 

write. c 

go  to  file() 

The  driver  function  to  write  the  draw- 
ing to  a  file. 

write    menu.c 

write  menu() 

To  display  the  write  menu  and  to  get 
the  users  selection. 
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Functions  -  Files                              || 

Functions 

Files 

alter  attributes() 

alter. c 

arc2irst() 

arc2fnl.c 

arc   inside() 

arc   inside. c 

arc   to  file() 

arc2fnl.c 

bad  data() 

bad.c 

barc"2list() 

arc2fnl.c 

bblockedit() 

blockedit.c 

bcircle2list() 

circle2fnl.c 

bdo   polygon() 

poly2fnl.c 

bdo  rectangle() 

poly2fnl.c 

bdraw  page() 

blockedit.c 

beHipse2list() 

ellipse2fnl.c 

bfile21ist() 

bfile2list.c 

bfind   objects() 

blockedit.c 

bfont21ist{) 

font2fnl.c 

bget  from  file() 

bread,  c 

binsert  arc() 

insert. c 

binsert   ellipse() 

insert  ell.c 

binsert   into  list() 

binsert. c 

binsert  seed{^) 

seed.c 

bline21ist() 

line2fnl.c 

blinestyle21ist() 

ls2fnl.c 

blinewidth21ist() 

lw2fnl.c 

blocic   edit() 

edit  menu.c 

blockedit() 

blockedit.c 

bmove  file() 

blockedit.c 

bpolygon2list() 

poly2fnl.c 

bseed21ist() 

seed2fnl.c 

btext21ist() 

text2fnl.c 

btexture21ist() 

texture2fnl.c 

change() 

change. c 

changefont() 

changefont.c 

changels() 

changels.c 

changelw() 

changelw.c 

changetexta() 

changetexta.c 

check    1st  lw() 

clean   list.c 

check    1st  not  default() 

clean   list.c 

check   arc() 

check   figure. c 

check   circle() 

check   figure. c 

check   correct() 

correct. c 

check   exit() 

exit.c 

check   line() 

check   figure. c 

check   text() 

check    figure. c 

circle21ist() 

circle2fnl.c 

circle   to  fileQ 

circle2fnl.c 
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clean  font{) 

clean   linestyle() 

clean   list() 

clean   texture() 

cleanupO 

clearpage() 

copyobjO 

dirdraw() 

dirscroll() 

display  _position() 

distance  between  () 

do_polygon() 

do  rectangle() 

draw_a() 

draw_arc() 

draw  arrow  0 

drawcircle() 

draw  erased  0 

draw   line() 

draw   multi   line() 

draw   page() 

draw   polygon() 

draw   rectangle() 

draw  smooth   line() 

draw_text() 

dupiicate() 

edit   menu() 

edit  obj() 

ellipse2list() 

ellipse  to  file() 

fig  menuQ 

file^listO 

find  figure() 

find   objects() 

font2list() 

font_size() 

font   to_file() 

fontsource() 

full  memory 0 

get  alignment() 

getangleO 

get   block() 

get   bottom() 

get  circleQ 


clean   list.c 

clean   list.c 

clean   list.c 

clean   list.c 

cleanup. c 

clearpage.c 

copy   obj.c 

dirdraw.c 

dirdraw.c 

display   pos.c 

dist.c 

poIy2fnl.c 

poly2fnl.c 

draw.c 

arc.c 

arrow. c 

circle. c 

draw  erased. c 

line.c 

multi   line.c 

blockedit.c 

polygon. c 

rectangle. c 

smoothline.c() 

text.c 

duplicate. c 

edit  menu.c 

edit  obj.c 

ellipse2fnl.c 

eUipse2fnl.c 

fig  menu.c 

file21ist.c 

find.c 

blockedit.c 

font2fnl.c 

font  size.c 

font2fnl.c 

fontsource.c 

full.c 

store  alignment. c 

angle. c 

getblock.c 

border. c 

getcircle.c 
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Files 

get  current  font() 

current. c 

get   current   Iinestyle() 

current. c 

get  current  linewidth() 

current. c 

get  current   texture() 

current. c 

get   directoryO 

get   dir.c 

get   from  file() 

read.c 

getJeftO" 

border. c 

get  next() 

file2Iist.c 

get   queue() 

getq.c 

get   real   linewidth() 

current. c 

get  user  alignment() 

alignment. c 

getlTstO  ~ 

getlist.c 

go  to  file() 

write. c 

graphlab() 

graphlab.c 

gtlpt   inside() 

gtlptinside.c 

index2ftable() 

readfonts.c 

init  attributes() 

current. c 

init  guides() 

init  guides. c 

init  textures() 

init   textures. c 

initialise() 

init.c 

initpopupO 

poputil.c 

insert  arc() 

insert  arc.c 

insert  diamond() 

insert   poly.c 

insert  eHipse() 

insert  ell.c 

insert   hdgl() 

text.c 

insert  into  list() 

insert. c 

insert  seed() 

seed.c 

insert   triangle() 

insert  poly.c 

insideO 

inside. c 

instructions() 

instruct. c 

invalid   entry() 

invalid. c 

line21ist() 

line2fnl.c 

line  menu() 

line  menu.c 

line  size() 

line  size.c 

line   to   file() 

Iine2fnl.c 

iinestyle2list() 

ls2fnl.c 

linestyle   to   file() 

ls2fnl.c 

linewidth2Iist() 

lw2fnl.c 

linewidth  to  file() 

lw2fnl.c() 

list   to  file() 

list2file.c 

Iw2pix0 

line   size.c 

main() 

npsdraw.c 

main   n:ienu() 

main   menu.c 

map(y 

map.c 

map  to  list() 

map.c 
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modify   arc() 

mod   arc.c 

modify  circle() 

mod   circle. c 

modify   ellipse() 

mod   ellipse. c 

modify   line() 

mod   line.c 

modify   object() 

mod   obj.c 

modify   polygon() 

mod   poly.c 

modify   seed() 

mod   seed.c 

modify   text() 

mod   text.c 

move  obj() 

move  obj.c 

move  page() 

move  page.c 

move  picked  objs() 

blockedit.c 

newcursor() 

cursor.c 

not  found 0 

not  found. c 

not  sensible() 

sensible. c 

one  pt  inside() 

Ipt  inside.c 

opening  display () 

welcome. c 

poly  to  file() 

poly2fnl.c 

polygon2list() 

poly2fnl.c 

popupO 

poputil.c 

printable() 

printable. c 

read   menu() 

read   menu.c 

readfonttable() 

readfonts.c 

redraw  figures() 

redraw. c 

remove   last() 

remove. c 

replace  hdgl   w   hdg2() 

text.c 

reproduce  last() 

copy   last.c 

reset   mouse  () 

set  mouse.c 

restrict  mouse() 

set  mouse.c 

seed   to  file() 

seed2fnl.c 

seed2list() 

seed2fnl.c 

select-text() 

sel  text.c 

select  font() 

sel  font.c 

select   ls() 

sel   Is.c 

select   lw() 

sel   Iw.c 

set  alignment() 

store  alignment. c 

set   bottom() 

border. c 

set  current  font() 

current. c 

set  current   linestyle() 

current. c 

set  current   linewidth() 

current. c 

set  current  texture() 

current. c 

set   filename() 

set  fname.c 

set   mouse 0 

set   mouse.c 

set  orthoview() 

set.c 

set  real  linewidth() 

current. c 

set  screen 0 

setnewscrn.c 
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showpopupO 

poputil.c 

syntax   error() 

syntax. c 

text21ist() 

text2fnl.c 

text   to   file() 

text2fnl.c 

texture21ist() 

texture2fnl.c 

texture  to  file() 

texture2fnl.c 

toggleO 

toggle  grid.c 

update  bounds() 

border. c 

var  lw() 

sel   Iw.c 

view   page() 

view   page.c 

width2lwnum() 

width21wnum.c 

write  menuQ 

write  menu.c 
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FUNCTIONS 

Function 

Called  From 

CaDs  To 

alter   attributes() 

edit  obj() 

changefont()      changels() 
changelw()        changetex- 
ta()                instructions() 
select  font()      select   ls() 
select   lw()  select   text() 

arc21ist() 

file21ist() 

insert  arc() 
map  to  list() 

arc   inside() 

find  objects() 

inside() 

arc   to   file() 

list2file() 

map() 

bad    data() 

bfile2list()  file2list() 

get  queue() 
redraw   figures() 
set  orthoview() 

barc21ist() 

bfile21ist() 

map   to   list() 
binsert  arc() 

bblockeditO 

block   edit() 

bfind   objects() 

bmove   file()  newcursor 

bcircle21ist() 

bfile21ist() 

binsert   into  list() 
map  to  list() 

bdo  polygon() 

bpolygon21ist() 

binsert   into  list() 
map  to  list() 

bdraw   page() 

bmove  file() 

get  bottom()      get   left() 
set  orthoview() 

bdo   rectangle() 

bpolygon21ist() 

binsert  into  list() 

bellipse2list() 

bfile21ist() 

binsert   into  list() 
map   to  list() 

bfile21ist() 

bget   from  file() 

bfile21ist()    instructions() 
set  current   font() 
set  current   linestyle() 
set  current   linewidth() 
set  current   texture() 
set  real   linewidth() 
set  written() 

bfind    objects 

bblockeditO 

[none] 
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Function 

Called  From 

CaDs  To 

bfont2list() 

bfile21ist() 

binsert   into  list() 
set  current   font() 

bget    from    file() 

block    edit() 

bfile21ist()    instructions() 
get   queue() 
set  current  font() 
set   current   linestyleO 
set  current   linewidth() 
set  current  texture() 
set  real   linewidth() 
set  written() 

binsert    arc() 

barc21ist() 

binsert   into  list() 

binsert    ellipse() 

bellipse2list() 

binsert   into   list() 

binsert    into   list() 

barc21ist() 

bcircle2list() 

bellipse21ist() 

bfile2list()    bfont2list() 

binsert   seed() 

bline21ist() 

bpoly21ist() 

btext2list() 

btexture2list() 

font   size() 
full   memory  0 
get  current  font() 
get   current   texture() 
get   current   linestyle() 
get  current   linewidthO 
get   real   linewidth() 
set  written() 

binsert    seed() 

bseed2list() 

binsert   into  list() 

bline21ist() 

bfile21ist() 

binsert2list() 
full   memoryO 
map   to  list() 

blinestyle21ist() 

bfile2list() 

binsert   to  list() 

set  current   linestyle() 

blinewidth21ist() 

bfile21ist() 

binsert   to   list() 

lw2pix() 

set   current   line() 

widthdth2lwnum() 
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Called  From 

Calls  To 

blockeditO 

block   edit() 

copyblock() 

find  objects() 

get   block() 

get   bottom()      get   left() 

get   queue() 

move  picked   objs() 

newcursor() 

redraw   figures() 

set  orhtoview() 

update  bounds() 

bmove    file() 

bblockedit() 

bdraw   page() 

display   position() 

get   bottom()      get   left() 

get  queue()            instruc- 

tions()      modify   object() 

update   bounds() 

bpolygon21ist() 

bfile21ist() 

bdo  rectangle() 
bdo  polygon() 
full  memory  0 

bseed2list() 

bfile21ist() 

binsert   seed() 
map  to  list() 

btext21ist() 

bfile21ist() 

binsert  into  list() 
get  current  font() 
get  current   linestyle() 
get  current   linewidth() 
map  to  list() 

btexture2list() 

bfile21ist() 

binsert   into  list() 
set  current   texture() 

change() 

fig  menu() 
line  menu() 
main   menu() 

insert  into  list() 
select   font()      select   ls() 
select   lw()     select   text() 
set   current  font() 
set   current   linestyle() 
set  current   linewidth() 
set  current  texture() 
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Function 

CaDed  From 

Calls  To 

changefont() 

alter  attributes() 

insert  into  list() 
invalid  entry() 
not  sensible() 

changels() 

alter  attributes() 

insert  into  list() 
invalid  entry() 
not  sensible  0 

changelw() 

alter  attributes() 

insert  into  list() 
invalid  entry() 
not  sensible() 

changetexta() 

alter  attributes 

insert  into  list() 
invalid  entry() 
not  sensible() 

check    1st    not    default () 

clean  list() 

[none] 

check    arc() 

find   figure() 

[none] 

check    circle() 

find   figure() 

[none] 

check    correct 0 

find   figure() 

draw  erased()    get   queue() 
instructions() 
redraw   figures() 
set   orthoview() 

check    exit() 

main  menu()() 

instructions()     newcursor() 
popupO  showpopupO 

check   lme() 

find   figure() 

[none] 

check    text() 

find   figure() 

[none] 

circle2list() 

file21ist() 

insert   into  list() 
map  to  list() 

circle   to   file() 

list2file() 

map() 

clean   font() 

clean   list() 

[none] 

clean   linestyle() 

clean   list() 

[none] 

clean   linestyle() 

clean   list() 

[none] 

clean   list() 

list2file() 

check    1st   lw() 

check  font() 

check   1st  not  default() 

check   Iinestyle() 

check   linewidth() 

check  texture() 

clean    font() 

clean  list() 

[none] 

clean    texture() 

clean   list() 

[none] 
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Function 

Called  From 

CaUs  To                  1 

cleanup  0 

getlistO            list2file() 
main() 

[none! 

clearpage() 

main   menu() 

instructions{)         newcur- 
sor()                         popupO 
redraw   figures() 
showpopupO 
set  current  font() 
set  current  linestyle() 
set  current  linewidth() 
set  current  texture() 
set   filename() 
set  orthoview() 
set   real   linewidth() 
set  screen 0 

copyblock() 

blockedit() 

display   position() 
draw   copyO    duplicate() 
get   bottom()      get   left() 
get   queue()             instruc- 
tions()      set   orthoview() 
set   written() 
update   bounds() 

copy    obj() 

copy   last()  edit  obj() 

get  alignment() 
get   bottom()      get   left() 
get  queue()            instruc- 
tions()      set  orthoview() 
update  bounds 

dirdraw() 

dirscroli() 

get  directory  0 

[nonet 

dirscroll() 

get   directory 0 

I  none j 
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Function 

CaUed  From 

Calls  To 

display   position() 

block   edit()          block- 

edit()          bmove  file() 

copy   obj()              copy- 

block()              draw   a() 

draw   arc() 

draw  arrow. c() 

draw   circle() 

draw   line() 

draw   multi   line() 

draw   polygon() 

draw   rectangle() 

draw  smooth   line() 

draw   text() 

edit  menu()  edit  obj() 

fig  menu()  get   block() 

get  circle() 

line   menu() 

main   menu() 

move   picked   objs() 

not   found 0 

replace   hdgl    w   hdg2() 

set  screen 0 

[none] 

distance   between() 

draw   circle() 
get  circle() 

[none] 

do  polygon() 

polygon21ist() 

insert  into  list() 
map  to  list() 

do   rectangle() 

polygon21ist() 

insert   into  list() 
map  to  list() 
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Function 

CaUed  From 

CaDs  To 

draw    a() 

fig  menu() 
line  menu() 
main   menu{) 

display   position() 

draw   arc() 

draw   arrow 0 

draw   circle() 

draw   line() 

draw   multi   lineO 

draw   polygon 0 

draw   rectangle() 

draw   smooth  line() 

draw   text()     get   block() 

get   bottom() 

get  circle()          get   left() 

get   queue() 

insert  diamond  () 

insert  ellipse() 

insert   seed() 

insert   triangle()    instruc- 

tions()              newcursor() 

remove  last() 

redraw  figures() 

reproduce   last() 

set   orthoview() 

update  bounds() 

draw   arc() 

draw  a() 

display   position() 

get   left()      get   bottom() 

get   queue()    insert   arc() 

instructions{) 

redraw   figures() 

set   orthoview() 
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Function 

Called  From 

Calls  To 

draw    arrow() 

draw  a() 

display   position() 

get   left()      get   bottom() 

get  queue() 

insert  into  list()  instruc- 

tions()     redraw   figures() 

set   current   linestyle() 

set  current   Iinewidth() 

set  current  texture() 

set  orthoview() 

set   real   linewidth() 

update  bounds() 

draw   circle() 

draw  a() 

get  bottom()      get   left() 
instructions() 
display   position() 
get  queue() 
set   orthoview() 
redraw   figures() 
update   bounds() 
insert   into   list() 

draw    copy() 

blockeditO 

get   bottom()      get   left() 
set   orthoview() 

draw   erased() 

check   correct() 
edit  obj() 

[NONE] 

draw   line() 

draw  a() 

get  bottom  0      get  left() 
get  queue()            instruc- 
tions()     restrict   mouse() 
set  orthoview() 
redraw   figures() 
update  bounds() 

draw   multi   llne() 

draw  a() 

get  bottom 0      get   left() 
get  queue()            instruc- 
tions()      redraw    figures() 
set  orthoview() 
update   bounds() 

130 


Function 

Called  From 

Calls  To 

draw    page() 

move   picked   objs() 

get   bottom()      get   left() 
set  orthoview() 

draw   polygon() 

draw  a() 

get   bottom()      get   left() 
get  queue() 
update  bounds() 
insert   into   list()  instruc- 
tions()     redraw   figures() 
set  orthoview() 

draw   rectangle() 

draw  a() 

display   position() 

get   bottom()      get   left() 

get  queue()            instruc- 

tions()    insert   into  list() 

redraw  figures() 

set  orthoview() 

update   bounds() 

draw    smooth    line() 

draw   a() 

display   posit,ion() 
get   bottom()      get   left() 
insert   into  list()  instruc- 
tions()     redraw   figures() 
set  orthoview() 
update  bounds() 

draw   text() 

draw   a() 

display   position() 

get   bottom() 

get  current  font() 

get   current   Iinewidth() 

get  current   linestyle() 

get   left()         get   queue () 

insert   hdgl() 

insert   into  list()  instruc- 

tions()     lw2pix()     print- 

able()       redraw   figures() 

remove   last() 

replace  hdgl   w   hdg2() 

set   ortoview() 

update  bounds() 
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Function 

CaDed  From 

Calls  To 

duplicate() 

copy  block  0 
copy   object  0 

full   memory  0 
get   current   font() 
get   current   linestyle() 
get   current   linewidth() 
get   real   linewidth() 
get  current   texture() 
insert   into   list() 
modify   object () 
set   current  font() 
set  current   linestyle() 
set  current   linewidth() 
set  current  texture() 
set   real   linewidth() 

edit    menuO 

main   menu() 

display   position()          in- 
structions()            popup() 
redraw   figures() 
showpopupO 

set   screen  0 

edit    obj() 

edit   menu() 
fig  menu() 
main   menu() 

alter  attributes() 

copy   obj() 

display   position  () 

find   figure() 

get   bottom() 

get   current   linestyle() 

get   current   linewidth() 

get   current    texture() 

get    left()  get   queue()  in- 

structions()     newcursor() 

redraw   figures() 

set  current   texture() 

set   current   linestyle() 

set   current   linewidth() 

set   orthoview() 

set   written() 

update   bounds() 

ellipse21ist() 

file21ist() 

insert  ellipse() 
map   to  list() 

ellipse   to    file() 

list2file() 

map() 
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Function 

CaDed  From 

Calls  To 

fig   menu() 

main   menu() 

change() 

display   position() 

draw   a()    edit   obj()    in- 

structions()           popup() 

redraw   figures() 

showpopupO 

set  screen 0 

file2list() 

get  from  file() 

arc2Iist()           bad   data() 
circle21ist()    ellipse21ist() 
font2list() 
get  current  font() 
get  current  linestyle() 
get   current   Iinewidth() 
get  current   texture() 
get   next() 
insert   into  list() 
line21ist()   rinestyle2Iist() 
linewidth21ist() 
polygon21ist()   seed2Iist() 
set  current  font() 
set  current   linestyle() 
set  current   Iinewidth() 
set  current  texture() 
syntax   error()  text2list() 
texture2list() 

find   figure() 

edit  obj() 

check   arc() 

check   circle() 

check   correct() 

check   line()  check   text() 

instructions() 

font21ist() 

file21ist() 

insert   into  list() 
set  current  font() 

font    sizeO 

binsert  into  list() 
btext2list() 
changefont() 
draw   text() 
insert   into  list() 
modify   text() 
text2list() 

index2ftable() 

font    to   file() 

list2file() 

[none] 
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Function 

Called  From 

Calls  To 

fontsource() 

select   font() 

instructions()        newcur- 
sor()                        popupO 
redraw   figures() 
set   screen 0        showpop- 

M) 

full  memory  0 

binsert   into  list() 

bline21ist() 

bpoly2list()           dupli- 

cate() 

insert   into  list() 

line21ist{)  poly2list() 

get   queue() 
redraw   figures() 
set   orthoview() 

get    alignment 0 

bmove  file()           copy- 
block()          copy   obj() 
init   guides() 
move  objO 
move  page() 
move  picked  objs() 
restrict   mouse() 
set  orthoview() 
set   mouse() 
set  screen 0 
update  bounds() 
view  page() 

get  queue() 

get    angle  0 

draw  arc() 
draw  arrow  0 

[none] 

get    block() 

blockedit()  draw  a() 

display   position() 
get   bottom() 
get   current   linewidth() 
get   left()  get   queue()  in- 
structions()           lw2pix() 
redraw   figures() 
set  orthoview() 
update   bounds() 
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Function 

Called  From 

Calls  To 

get    bottomO 

bdraw   page()       block- 
edit()          bmove  file() 
copy   obj()              copy- 
block()              draw  a() 
draw  arc() 
draw  arrow  0 
draw  circle() 
draw  line() 
draw   page() 
draw  copy() 
draw   multi  line() 
draw  polygon() 
draw   rectangle() 
draw   smooth   line() 
draw  text()  edit  obj() 
get   block()    getcircle() 
move  picked   objs() 
move  obj() 
not  found  0 
restrict   mouse() 
set   orthoview() 

[none] 

get    circle() 

draw   a() 

display   position() 
distance  between() 
get  bottom()      get  left() 
get  queue()            instruc- 
tions()     redraw   figures() 
set  orthoview() 
update   bounds() 

get    current   font() 

bfile2list() 

binsert   into  list() 

btext21ist{)  ~ 

draw   text()           dulpi- 

cateO^               file21ist() 

insert   into  list() 

select  font() 

set   screen()  text21ist() 

[none] 
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Function 

CaUed  From 

Calls  To 

get    current    linestyle() 

bfile21ist() 

binsert   into   list() 

binsert   seed() 

btext2irst() 

draw  arrow  0 

draw   text()           dupli- 

cate()                file2list() 

insert   into  list() 

insert  seed() 

modify   seed() 

set  screen()  text21ist() 

[none] 

get    current    linewidth() 

bfile2list() 

binsert   into   list() 

binsert   seed() 

btext21ist() 

draw   arrow  0 

draw   text()           dupli- 

cate()               edit   obj() 

file21ist()        getblockQ 

insert   into  list() 

insert  seed() 

set   screen()  text2list() 

[none 

get    current    texture() 

bfile21ist() 
binsert   into  list() 
draw   arrow()       dupli- 
cate ()              edit  objO 
file21ist() 
insert   into  list() 
insert  seed{) 
binsert  seed() 
set   screen  0 

[none] 

get    directory 0 

read   menu() 
write   menu() 

dirdraw()  dirscrollf) 
list()       get   queue{) 
structions{) 

get- 
in- 
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Function 

Called  From 

Calls  To 

get    from    file() 

read   menu() 

drawing  exists() 

get   queue()  file21ist()  in- 

structions() 

set   current   font() 

set   current   linestyle() 

set   current   linewidth() 

set  current   texture() 

set  real   linewidth() 

set  filename() 

set  written() 

getleftO 

bdraw   page()       block- 
edit()          bmove  file() 
copy   obj()              copy- 
block  0              draw   a() 
draw  arc() 
draw   arrow  0 
draw  circle() 
draw  copy() 
draw   multi   line() 
draw   page() 
draw   polygon() 
draw   rectangle() 
draw  smooth  line() 
edit  obj()      getblock() 
getcircle()    draw  Iine() 
move  obj() 
move  picked  objs() 
not  found  0 
restrict   mouse() 
replace   hdgl   w  dhg2() 
set   orthoview() 

[none] 

get    next() 

bfile21ist()  file2list() 

[none] 
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Function 

Called  From 

Calls  To 

get    queue() 

bad  data{) 

bget  from  file()  block- 

edit()            bmovefile() 

check   correct() 

copy   obj()              copy- 

block()              draw   a() 

draw  arc() 

draw  arrow  0 

draw  circle() 

draw   line() 

draw   multi   line() 

draw   polygon() 

draw   rectangle() 

draw   text()  edit  obj() 

full  memory  0 

get   user  alignment() 

get  directory  0 

get  circle() 

get  from   file()         get- 

block()  go   to   file()  in- 

valid()          move  obj() 

move  page() 

move  picked   objs() 

not  found  0 

select  font() 

select  lw()      sensible() 

syntax  error() 

view   page() 

[none] 
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Function 

Called  From 

Calls  To 

get    real   lmewidth() 

binsert   into   list() 
draw   arrow  0 
insert   into   list() 

[none] 

get    user    alignment() 

main() 

get  queue()            inside() 
set   alignment() 

go   to   file() 

wite  menu() 

get   queue()            instruc- 

tions()             list   to   file() 
set   written() 

gtlpt    inside() 

find   objects() 

inside() 

index2ftable() 

alter  attributes() 

changefont()     changetex- 

font  size() 

ta()                      changels() 

select   font() 

changelw() 

set  screen 0 

index2ftable()        instruc- 

tions()                     popupO 

select   font() 

select   texture() 

select   ls()         select   lw() 

set  screen()         showpop- 

M) 

init    attributes() 

initialise() 

[none] 

init   guides  0 

main() 

get   alignment() 
insert   into  list() 

initpopupO 

main() 

[none] 

insert    arc() 

arc2list()        barc21ist() 
insert   arc() 

insert   into  list() 

insert    diamond  () 

draw  a() 

insert   into   list() 

insert    ellipse() 

draw   a() 

insert   into  list() 

insert   hdgl() 

draw   text() 

get   bottom()      get   left() 
insert   into  Iist() 
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Function 

Called  From 

Calls  To 

insert    into   list() 

change()     changefont() 

changels()     changelw() 

changetexta() 

draw  a() 

draw   arrow 0 

draw   circle() 

draw   line() 

full   memoryO 

font   size() 

get   current   font() 

get  current   linestyle() 

get  current   linewidth() 

get   real   iinewidth() 

get  current   texture() 

draw  multi   line() 
draw  polygon() 
draw   rectangle() 
draw  smoothline() 

set  written() 

draw   text()           dupli- 

cate()                {ile21ist() 
font   to  file() 

init   guides() 

insert  arc{) 

insert   diamond() 

insert  ellipse() 
insert   seed() 

insert   triangle() 
line   to  file() 
Is  to  fileO 
lw_to_file() 
poly   to  file() 
text   to  file() 
texture  to   file() 

insert    seed() 

seed2file() 

get  current   linestyle() 
get   current   linewidth() 
get   current   texture() 
insert   into  list() 

insert    triangle() 

draw   a() 

insert  into  list() 

inside() 

get   user  alignment() 
gtlpt   inside() 
one   pt   inside() 
select   text() 

[none] 
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Function 

Called  From 

CaUs  To 

instructions() 

alter  attributes() 

bget  from  file() 

block   edit()          block- 

edit()          bmove  file() 

check   exit()           clear- 

page()          copyblock() 

copy_obj() 

check  correct() 

draw  a()      draw  arc() 

draw  arrow  0 

draw  circle() 

draw  line() 

draw   multi   line() 

draw  polygon() 

draw  rectangle() 

draw  smooth  line() 

draw  text() 

edit   menu()  edit  obj() 

fig  menu() 

find   figure() 

fontsource() 

get  from  file() 

go  to  file() 

get  directory  0        get- 

block()  get  circle()  in- 

valid()         line  menu() 

main   menu() 

move  obj() 

move  page() 

move  picked  objects() 

not  found() 

read   menu() 

select  font() 

select  ls()     select   lw() 

select   text()  sensible() 

set  screen() 

view  page() 

write  menu() 

[none] 

invalid    entry() 

changels()     changelw() 

get   gueue()             instruc- 

changetexta() 

tions()      redraw   figures() 
set   orthoview() 
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Function 

Called  From 

Calls  To 

lme2list() 

file21ist() 

full  memory  0 
insert  into  list() 
map   to   list() 

line   menu() 

main  menu() 

change() 

display   position() 

draw  a()      instructions() 

popupO  redraw   figures() 

showpopupO 

set  screen() 

line   size() 

change()  duplicate() 

[none] 

line   to   file() 

list2file() 

map() 

linestyle21ist() 

file21ist() 

insert  into  list() 

set  current   linestyle() 

linestyle   to   file() 

list  to  file() 

[none] 

linewidth21ist() 

file21ist() 

insert  into  list() 

lw2pix() 

set  current   linewidth() 

width21wnum() 

linewidth    to   file() 

list   to   file() 

[none] 

list    to    file() 

go  to   file() 

arc   to  file() 

circle  to  file()    cleanup() 

clean  list() 

ellipse  to  file() 

font   to  fiTe() 

line  to  file() 

linestyle  to  file() 

linewidth   to  file() 

poly  to  file() 

seed   to  file() 

text   to  file() 

texture  to  file() 
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Function 

CaDed  From 

Calls  To 

lw2pix() 

binsert   into  list() 

binsert  seed() 

blinewidth21ist() 

btext2list()       change() 

changefont() 

changelw() 

draw   arrow() 

draw   text()           dupli- 

cate()              getbIock() 

insert   into  list() 

insert  seed() 

linewidth21ist() 

modify   seed() 

modify   text() 

move  obj()  text2list() 

[none] 

mainO 

Activated      from      the 
illustrator   system   call 
NPSDRAW 

cleanupO 

get   user  alignment{) 

init   guides()      initialise() 

initpopup     main   menu() 

opening   display ()      read- 

fonttable() 

main   nienu() 

main() 

block   edit()          change() 

check   exit()     clearpage() 

display   position() 

draw   a()             edit   obj() 

edit   menu()     fig   menu() 

instructions() 

line  menu()           popup() 

read   menu() 

redraw   figures() 

set   screen 0 

set  orthoview() 

showpopupO 

togglegridO 

view   page() 

write  menu() 
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Function 

CaDed  From 

Calls  To 

map() 

arc   to  file() 
circle  to  file() 
ellipse  to  file() 
line   to   file() 
poly    to   file() 
seed2file() 
text   to  file() 

map    to   list() 

arc21ist()        barc21ist() 

bcircle2list() 

bellipse21ist() 

bline21ist() 

bpolygon2list() 

bseed21ist() 

btext2list() 

circle21ist() 

ellipse21ist()    line21ist() 

polygon2list() 

seed21ist()  text21ist() 

[none] 

modify   arc() 

modify   onject() 

[none] 

modify   circle  () 

modify   object() 

[none] 

modify   ellipse() 

modify   object () 

jnone] 

modify   line() 

modify   object() 

[none] 

modify   object () 

bmove  file()          dulpi- 
cate()         move  page() 
move  picked   objs() 
move  obj() 

modify   arc() 
modify   circle() 
modify   ellipse() 
modify   line() 
modify  seed() 
modify   text() 
modify  polygon{) 

modify   polygon  ( ) 

modify   object() 

none] 

modify    seed() 

modify   object() 

get  current   linestyle() 

modify    text() 

modify   object() 

[none] 

move  obj() 

edit  obj() 

get  left()      get   bottom  () 
get  queue()            instruc- 
tions()      modify   object{) 
set   orthoview() 
update   bounds() 

move   page() 

edit   menu() 

get  alignment() 
get   queue()             instruc- 
tions()      modify   object() 
set  written() 
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Function 

Called  From 

CaUs  To 

move   picked    objs() 

blockedit() 

display   position() 
draw   page() 
get   alignment() 
get   bottom()      get   left() 
get   queue()            instruc- 
tions ()      modify   object () 
set  orthoview() 
set  written() 
update  bounds() 

newcursor() 

bblockeditO          block- 
edit()          check  exit() 
clearpage()      draw  a() 
edit  obj()  fontsource() 
opening  display  ()  pop- 
up()            read   menu() 
select   font() 
select   ls()     select   lw() 
select   text()  showpop- 
up()  write  menu() 

[none] 

not    found() 

blockedit() 
find   figure() 

display   position() 
get   bottom()      get   left() 
get   queue()            instruc- 
tions()  set  orthoview() 

not   sensible() 

changefont() 
changels()  changelw() 

get  queue()            instruc- 
tions()     redraw   figures() 
set  orthoview() 

one   pt    inside() 

find  objects() 

inside() 

opening   display () 

main() 

newcursor() 

poly   to   file() 

list  to  file() 

map() 
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Function 

CaDed  From 

Calls  To 

popup 0 

alter  attributes() 

check   exit()           clear- 

page()          edit   menu() 

fig  menu() 

fontsource() 

line  menu() 

main   menu() 

read  menu() 

select  font() 

select  ls()     select   lw() 

write  menu() 

[none] 

print  able() 

draw  text() 

[none] 

read   menu() 

main   menu() 

get   directory  0 

get  from  file()      instruc- 

tions()    newcursor()    pop- 

up()          redraw   figures() 

set   orthoview() 

set   screen()         showpop- 

readfontable() 

main() 

[none] 

146 


Function 

Called  From 

Calls  To 

redraw    figures() 

bad  data()  blockedit() 

check   correct()     clear- 

page()                draw   a() 

draw   arc() 

draw   arrow 0 

draw  circle() 

draw  line() 

draw   multi   line() 

draw   polygon 0 

draw   rectangle() 

draw  smooth  line() 

draw   text() 

edit   menu()  edit   obj() 

fig  menu() 

fontsource() 

full   memory {)          get- 

block()  get  circle()  in- 

valid()         line  menu() 

main   menu() 

read   menu() 

select   font()  sensible() 

set  screen  0 

view  page() 

write  menu() 

inonel 

remove  last() 

draw  a()  draw   text() 

[none] 

replace   hdgl   whdg2() 

draw   text() 

get   bottom()      get   left() 
insert   into  list() 
remove  last() 

reproduce   last() 

draw  a() 

[none] 

reset    mouse() 

draw   line() 
select   lw() 

get   alignment  0 

restrict    mouse() 

draw   line() 

get   alignment() 

get   left()  get   bottom() 

seed    to    file() 

list  to  file() 

map() 

seed2list() 

file2list() 

insert   seed() 
map  to  list() 

select    text() 

alter  attributes() 
changeO 

inside()         instructions() 
newcursor() 
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Function 

Called  From 

CaUs  To 

select    font() 

alter  attributes() 

fontsource() 

change() 

get  current   font() 
get   queue() 

index2ftable()        instruc- 
tions()   newcursor()   pop- 
up()          redraw   figures() 
set  screen()        showpop- 

upQ 

select    ls() 

alter  attributes() 

instructions()        newcur- 

change() 

sor()    popupO    showpop- 
up() 

select    lw() 

alter  attributes() 

get  queue()            instruc- 

change() 

tions()    newcursor()    pop- 
upO               showpopupO 
varlw() 

set    alignment 0 

get   user  alignment  () 

[none] 

set    bottom() 

set   screen () 

[none] 

set    current    font() 

bfile21ist()    bfont21ist() 

set  screen 0 

change()       ciearpage() 

duplicate()       file2list() 

font21ist() 

get   from  file() 

set    current    linestyle() 

bfile21ist() 

bget  from  file() 

blinestyle2Tist() 

change()        ciearpage() 

draw   arrow  0       dulpi- 

cate()               edit   obj() 

file21ist() 

get   from  file() 

linestyle21ist() 

set  screen{) 

set    current    linewidth() 

draw   arrow 0 

set  screen  0 

bfile2rist() 

bget   from   file() 

blinewidth2Iist() 

change()       ciearpagef) 

duplicate()     edit   obj() 

fi!e2list() 

get  from  file() 

linewidth21ist() 
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Function 

Called  From 

Calls  To 

set    current    texture() 

bfile21ist() 

set  screen() 

bget  from   file() 

change()       clearpage() 

draw  arrow()       dupli- 

cate()              edit  obj() 

file2list() 

get  from  file() 

texture2Iist() 

texture21ist() 

set    filenameO 

clearpage() 
get  from   file() 

[none] 

set    left() 

set  screen() 

[none] 

set    orthoview() 

bad  data() 

get   alignment() 

bdraw   page()       block- 

get   bottom()      get   left() 

edit()          bmove   file() 

get  queue() 

clearpage() 

check   correct() 

copy   obj()              copy- 

block  0          draw  arc() 

draw  arrow  0 

draw  copy() 

draw  page()   draw  a() 

draw  circle() 

draw   line() 

draw   multi   line() 

draw   polygon() 

draw   rectangle() 

draw  smooth   line() 

draw   text()  edit  obj() 

full   memory  0 

get   bottom() 

get  circle()     get   left() 

getblock() 

insert   diamond  ()       in- 

valid()      main   menu() 

, 

move  obJO 

move   picked   objs() 

not   found  0 

read  menu()  sensible() 

set  screen 0 

syntax  error() 
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Function 

Called  From 

Calls  To 

set    real  lmewidth() 

bfile2list() 
bget   from  file() 
change()       clearpage() 
draw  arrow()       dulpi- 
cate()                file2list() 
get   from   file() 

[none] 

set    screen 0 

alter  attributes() 

clearpage()  copy   last() 

edit   menu() 

fig  menu() 

fontsource() 

line   menu() 

main   menu() 

read   menu() 

set  current  font() 

set  current  linestyle() 

set   current   linewidth() 

set   current   texture() 

select   font() 

view   page() 

write   menu() 

display  position () 
get  alignment() 
get  current   texture() 
get  current   linestyle() 
get  current   linewidth() 
get  current  font() 
index2ftable()        instruc- 
tions()     redraw   figures() 
set   bottom()      set  left() 
set   orthoview() 

showpopupO 

alter  attributes() 

clearpage() 

check   exit() 

edit   menu() 

fig   menu() 

fontsource() 

line   menu() 

main   menu() 

read   menu() 

select   font() 

select   ls()     select    lw() 

write   menu() 

newcursor() 

syntax    error() 

bfile2list()  file2list() 

get   queue() 
redraw   figures() 
set  orthoview() 

text21ist() 

file2list() 

font   size() 
get  current   font() 
get  current   linestyle() 
get  currnet   linewidth() 
insert  into  list() 
map  to  list() 
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Function 

CaUed  From 

Calls  To 

text    to    file() 

list2file() 

map() 

texture21ist() 

list2file() 

insert   into  list() 
set  current   texture() 

texture    to   file() 

list2file() 

[none] 

toggle_grid() 

main   menu() 

[none] 

update   bounds() 

blockeditO 

bmove   file()           copy- 
block  ()           copy   obj() 
draw   a() 
draw   arrow() 
draw  circle() 
draw   lineO 
draw   multi   Iine() 
draw   polygon() 
draw   rectangle() 
draw   smooth   line() 
draw   text()   edit   obj() 
get   block() 
get   circle() 
move  obj() 
move  picked  objs() 

get  alignment() 

view   page() 

main  menu() 

get  alignment() 

get  queue()            instruc- 

tions()     redraw   figures() 

set   screen 0 

Avidth2lwnum( ) 

blinewidth21ist() 
linewidth21ist() 

[nonej 

write   menu() 

main   menu() 

get  directoryO 

go  to   file()             instruc- 

tions()    newcursorO    pop- 

up()          redraw    figuresO 

showpopupO 

set   screen 0 
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APPENDIX  C 


PRODUCTS  OF  NPSDRAW 


The  following  pages  are  examples  of  pictures  created  on  NPSDRAW. 
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FREE  BODY  DIAGRAM 
(Agent,  on  Surface) 


Example  1 
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TERRAIN  MOBILITY  MODEL 


MOBILITY        ENVIRONMENT 


Mission 
Events 


MISSION 
EXPERT 


Agent 

Events 


AGENT 
EXPERT 


Situation 
Events 


SITUATION 
EXPERT 


TERRAIN 
EXPERT 


AREA     OF    INTEREST 


Con  text-Dependent 

Mob i  I  I  ty     Map 


Pro  file     Gen e  ra  t i on        View     Genera t  i  on 


Example  2 
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view  from  t-he  side 


B 


view  from  the  front 

ASV  Leg  Configuration 
Exsunple  3 
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area-cost  map  model  of  region  boundary 


Real-world  region  boundary 


(a) .  Real-World  and  Model  Region  Boundaries 


high-cost  region 
cost  rate  C 


low-cost  region 
cost  rate  C 


P2     PI 

area-cost  map 
model  of  region  boundary 


(b) .  Error  Analysis  Illustration 
Path-Cost  Error  Due  To  Misplacerd  Boundaries 

Example  4 
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B  -  Goal 


dl 


^jA  -  Start 


Optimal  Paths  Through  Adjacent  Areas 


Exajnple  5 
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Inset  -  generating  problem 


Close  (X)  Function 


Example  6 
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Naval  Postgraduate  School 
Monterey,  California   93943-5000 

4.  Chief  of  Naval  Operations  1 
Director,  Information  Systems  (OP-945) 

Navy  Department 
Washington,  DC  20350-2000 

5.  Lieutenant  Commander  Thomas  J.  Beda  1 
Tactical  Electronic  Warfare  Squadron  Thirty  Three 

NAS  Key  West,  Florida  33040 

6.  Chairman  (Code  52)  1 
Department  of  Computer  Science 

Naval  Postgraduate  School 
Monterey,  California  93943-5000 

7.  Computer  Technology  Curricular  Officer  (Code  37)  1 
Naval  Postgraduate  School 

Monterey,  California  93943-5000 
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